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(54) Extensible distributed enterprise application Integration system and methods of operating 
same 


(57) A system for integrating a plurality of computer 
applications has an enterprise messaging system, said 
enterprise messaging system passing messages 
between said computer applications. A datat>ase, stor- 
age system coupled to said enterprise messaging sys- 
tem stores a plurality of data transformation 
configurations and a plurality of rules. An integration 
sendees is coupled to said enterprise messaging sys- 
tem, and comprises a data transformation engine using 
the data transformation configurations stored in said 
datat>ase storage system and a rules evaluation engine 
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using tine rules stored in said database storage system. 
A plurality of agent-adapters are coupled to said enter- 
prise messaging system, each coupled to a respective 
one of said conputer applications, each agent-adapter 
passir>g messages t>etween said enterprise messaging 
system and said respective computer application. A 
message schema operates in conjunction with said 
agent^adapters to parse individual message elements 
from the computer applications. 
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Description 

[0001 1 The present invention is related generally to wtmt has become known In the computing arts as "nBddleware". 
arxj more particularty to an extensile cfistributed system and methods of operating same to integrate applications of 
5 the type that are normally deployed across a networked enterpr^. 

[0002] According to one observer, tf the lifeblood of today's corporations is infomnation, then their arteries are the 
"Inter-application Interfaces' that facilitate movement of data around the corporate enterprisa This has more recently 
become known as an 'application network". 

[0003] For the typical organizatioa the application network has grown organically into a collection of ad hoc appB- 
10 cation integration programs. Th^ menagerie has had a very serious impact on tx^nesses as it increases the time for 
implementing new applications, prevents senior management from getting a dear picture of the business and. in short, 
cbgs the corporate arteries, tn spite of the iatit that application Integration has become crudal to a competitive corpo- 
ratkxi*8 survival, it has nevertheless been acceptable in the prior art to handcraft or "hack" custom code for such pur- 
poses at enormoi^ long-term cost to the corporation. Long-term application lntegratk>n decteions have, likewise, been 
IS made at the lowest possible levels based solely on individual project criteria. Because of the decidedly dSifiicun nature 
of these problems, an effective enterprise application Integration (EAI) solution has yet to be found. 
[0004] The advent of the Intern^, dient/^erver computing, corporate mergers and acquisitk>ns, globalization and 
business process re-engineering, have together forced corporate Infornrtation technology (IT) departments to continu- 
ally seek out new, and often manual, ways to make different systems talk to each other — regardless of how oM son>e 
20 of those systems may be. In the ertsuing chaos. Inadequate comnunrcations systems have had a debilitating effect on 
rPs abilities to move as fast as the business needs It to. 

[0005] Recent trends in IT have only exaceft)ated this problem by Inaeasing — often by an order of magnitude — 
the amount of inter-applicatk>n interladng needed to support them. Most recently, enterprise applications have per- 
formed such functions as data warehousing and enterprise resource planning (ERP). and fadGlated electronic com- 
25 merce. A brief review of these three techrK>logies would, therefore, be helpful in understarxling the long-felt txit as yet 
unresolved need for EAI. 

[0006] Data warehousing techniques require large volumes of dean historical data that mxsX be moved, on a reg- 
ular t>asis, from many operational systems Into the warehouse. Source data is usually structured for online transactional 
processing (OLTP). while the typical data warehouse also accommodates online analytical processing (OLAP) formats. 

30 Therefore, the source data must undergo extensive aggregation and reformatting as it is transferred to the warehouse. 
[0007] A typical data warehouse accorcfing to the prior art is populated in four steps: (a) extracting the source data; 
(b) deaning such extracted data; (c) aggregating the deaned, extracted data in a number of dimensions; and (d) foad- 
ing the warehouse. Each rarehouse source requires the building of a specific data extraction, deansing, aggregation, 
and load routine. Forester Research estimates that the average large company has approximately four data ware- 

35 houses. In two years, it is expected that this number will grow to six. The average amount of data contained in each 
warehouse is also expected to double in size in that same period — from about 130 gigabytes to about 260 gigat)ytes. 
[0008] The problems assodated with such large amounts of data growing at an ever-increasing pace is exacer- 
bated by the quality of source data. According to a study conducted by the META Group, typfoal data warehouses are 
t>eing loaded today with as much as 20% poor quality data. That same study Indicates that about 70% of its respond- 

40 ents used extraction, deansing and loading processes that were coded by hand. With respect to the required aggrega- 
tion processes, anecdotal evidence also reveals that as much as 50 hours of computer time may be required to 
complete this function alone. It ts readily apparent that significant maintenance efforts woukJ be Involved with programs 
coded in such a manner. 

[0009] On the other hand. typk;al ERP systems (such as the R/3 enterprise application developed by SAP AG of 
45 Walldorf. Germany, as well as those developed by PeopleSoft Grade, and Baan) are essentially large, integrated pack- 
aged applications tfiat support core business functior^, such as payroll, manufacturing, general ledger, and human 
resources. Large corporatior^ find It particularty attractive to buy such software solutions from a single source, since it 
can cost between 10 to 20 times more to devefop ttie same functionality In-hoi^ than to purchase it Implementing an 
ERP system, however, can be an ovenwhelming process for a number of reasons. 
50 [001 0] Rrst and foremost, the corporation is buying a product and not building a solution. This means that business 
units wittiin tiie corporation must adapt to the product and how it works, not the other way around. Furthermore, toda/s 
ERP systems cannot replace all of a corporation's custom sdutions. They must, therefore, communicate effectively with 
other legacy systems In place. Rnally, it is not atypfoal for a corporation to employ more than one and completely differ- 
ent ERP system because a single vendor cannot usually meet every organizational need. 
55 [001 1] As a result, the options for getting data into and out of an ERP system predude known approaches used for 
data warehousing. Each ERP system has a proprietary data model that is constantiy being enhanced by its vendor. 
Writing extract or load routines that manipulate such models is not only complicated, but \s also discouraged by the ven- 
dor since data validation and bi^lness rules inherent in the enterprise application are likely to be bypassed. Instead. 
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ERPs require interaction at the tx^tness object level which deals with specffic business entities such as general ledg- 
ers, budg^ or accounts payable. Further detail regarding Inplenientation and use of one well-kncwn and widely 
accepted ERP system may be found in Special Edition Using SAP R/3 (2d ed.), ISBN: 0-7897-1351 -9, by Que Corpo- 
ration (1997). 

5 [001 2] Electronic convnerce in one form or another has been around for nrany years. In essence, rt got its start with 
electronic data interchange (EDI). EDI permitted companies to communicate their purchase orders and invoices elec- 
tronk;ally. and continued to develop such that toda/s companies use EDI for supply chain management. However, not 
until the nfK>re recent explocfing use of online Internet websites to buy. sell, and even auction, items of interest has there 
been such a dire need for robust, effective EAI. See. e.g., U.S. Patent Na 5.627,972. 

10 [001 3] Applications get developed in order to accomplish a specific business objective in a measured time frame. 
In a typical large organization, different teanr^ of people i^ng a wide assortment of operating systems. DBMSs and 
development tools develop hundreds of applications. In each case, the specific requirements are satisfied without 
regard for integration with any other applications. 

[0014] Several powerful trends are driving the market for application integration. For example, significant develop- 
75 ments in peer-to-peer networking and distributed processing have made it possble for businesses to better integrate 
their own functional departments as well as integrate with th^r partners and suppliers. The aforementioned Inter- 
netTintranetTextranet" explosion is also fueling the demand for a new class of "human active" applications that require 
integration with back-erxJ legacy applications. Tremendous growth around the world in the adoption of enterprise appli- 
cation software packages (e.^.. SAP R/3) also requires integration with back-end legacy applicatior^ Rnally. message 
20 oriented middleware (MOM) — products such as IBM*s MQSeries message queuing product — are becoming increas- 
ingly popular. Once customers realize the benefits of sinrple one-to-one application connectivity with MOM. their inter- 
est in many-to-many application integration increases significantly. 

[001 5] As the need for businesses to integrate grows, the number of IT dollars spent on integrating applications is 
increasing rapidly. According to various industry analysts, the need for "mission critical'* application integration will drive 
25 the combined market for MOM and "message brokers" to grow from $300 million in 1997 to over $700 millbn in 1999. 
According to an IBM survey of larger customers, neariy 70% of all code written today consists of interfaces, protocols 
arvj other procedures to estat)lish linkages anrxxig various systems. Savvy IT executives can deariy see the dollar sav- 
ings to be gained by acquiring off-the-shelf software to satisfy as much of thte requirement as possbia 
[001 6] A message broker is a software hub that recorcte and manages the contracts t>etween publishers {i.e„ send- 
so ers) arxJ sut>scribers {Le., receivers) of messages. When a txjsiness event takes place, the applteation will publish the 
message(s) corresponcfing to that txisiness event The broker reviews its lists of sut>scriptions and activates delivery to 
each sut}scrft>er for that message typ>a Subscribers receive only the data to which they sut>scrft>e. A message put>- 
lished by one application can be sut>scrit)ed to by rmiltiple consumer applications. Similarly, a sut>scrft>ing applk;ation 
can receive messages from multple puk)lishing applications. 
35 [0017] Before applications can publish or subscribe to messages..th^ must register their interest with the broker. 
There are two basic and different methods for applications to register interest in a message type — subject-based 
addressing and message-content fOtering. In subject-based addressing, the txoker uses tfie subject to identify arxl 
route the message to all parties expressing interest in that subject The subject is a word used to describe the contents 
of the message. For example, a subject of the name "hr. emp. new." could serve to dstrifcxite information (e.^., name. 
40 address, employee nunrter. etc.) on a newly hired employee. In message content routing, on the other hand, subscrip- 
tions are made t>ased on the contents of fields within the message. The sut>scrqptk)ns can be based upon the message 
type and/or specific selection criteria relative to a f ieU within the messaga For example, a loan approval application 
couU subscribe to all purchase orders over $100,000. 

[0018] One advantage to having two publish/!5ut>scribe paradigms is that the need to address messages to individ- 
45 ual subscribing applications is avoided. Additionally, new sut)scrbing applk^atbns can be added without any changes 
to the publishing application. 

[0019] The typical publishing/subscrbing t>roker uses a robust delivery vehk:le for the actual distrbution of mes- 
sages b^een applications. As m^k>n crrtk^al messages travel over a combinatfon of external and internal networks, 
the systems software ensures that messages are never lost or dupb'cated in the event of network failures. More often 

so than not an asynchronous message delivery capability is provkied which i^es store-and-forward message queuing. In 
this paradigm, the queue-to-queue transfer takes place in pseudo-real time when the subscribing application is availa- 
ble. If the sut)scribing applk:ation is unavailat)le. the message is stored in a persistent queue for later delivery. 
[0020] To be effective, the message delivery vehicle must include a business transaction coordination function. A 
business transaction is typk:ally made up of several units of worie Each and every unit of work must complete in order 

55 for the transaction to occur. If even one unit of work fails, the whole transaction fails, and all completed units of work 
must then be reversed. These transactfor^ are long mnning and require message-based updates to multiple data- 
bases. The business transaction coordinatfon function provides this managerial support. 

[0021 ] Two other important corrponents are the rules-based engine and the data-transfonnation corrponent. The 
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kx^iness rules engine allows organizations to process messages based upon the unique requirements of their busi- 
ness. TypicaDy, business rules engines provide a visual front end to avoid the need for programming in a procediral lan- 
guage With this flexftsle approach, changes in business processes can be easily reflected in a modified rules 
configuration. 

5 [0022] The data transformation component is used to develop application-specific adapters. These adapters con- 
vert the data formats and applications semantics from the sending application to the receiving application. There are 
many conversion requirements. They range from basic data transformation to resolving the incompattoiBties that exfet 
between the structure (Le., syntax), meaning (/.e., semantics) and tining of the information that must be shared. 
[0023] There are two main strategies for application adapters according to the prior art One strategy is to convert 

10 all of the source data arxi synchronize (or "sync'O applications to a starxlard canonical form. Messages move from the 
source adapter to the sync adapter in this standard form. At the sync adapter, the messages are convened to the format 
of the sync application. 

[0024] The second strategy for application adapters is to automatically convert the format and semantics from the 
sending application to the receiving ajsplication in one step, without any intermediate formats. In this approach, only one 
75 adapter s required for two applications to communicate with each other and it can be integrated with either of the appli- 
cations. . 

[0025] The rules based engine and the data transformation component work together to reconcile the differences 
between applicatior^. For example, before two applications can be integrated around an order, the business rules 
regarding the processing of orders must l>e d^ined wittiin each system. Within Application "A." an order might be com- 

20 prteed of a collection of data from nrultiple files arxi datat)ases: whereas within Application "B," an order might exist as 
an individual message nested within a larger file of business transactions. The difficult challenge is to resolve the incom- 
patibilities between the structure of the data and the underlying content of an order as d^ined in each application. 
[0026] There are a number of potential business benefits that message brokering provide. Rrst of all is their ease 
of application integration. With message brokers, the integration of new applications with existing legacy or ttiird-party 

25 applications can t>e performed in a shorter period of time The integration can take place wittraut any need for under- 
standing the internal structure and design of each application. By focusing on the interface as messages, existing appli- 
cations can be integrated with minimal disruption. 

[0027] SLf)port for electronk: commerce is a second t>en6frt that message brokering provides. As businesses begin 
to automate the supply chain of their vendors and partners, there is a need for their indeperxJent applications to com- 
30 nrujnk:ate in a loosely coupled manner. This is precisely the essence and strength of message brokering. The message 
txoker is completely congruent with the business need. 

[0028] Last, but certainly not least, is message brokering*s support for continued heterogeneity. As new technology 
has evolved, new architectures have been developed and heterogeneity is inaeasing over time. A methodology such 
as message brokering is designed to accommodate today's heterogeneous worid and will be useful in the futura New. 
35 differing applk^ations can be added over time as either publishers or sutjscribers. without any changes to the existing 
applk;ations in the message t>roker. 

[0029] In summary, message brokers have the potential to provkie a least-common<ienominator approach to inte- 
grating heterogeneous applcations within an enterprise. Users can choose the best technology for each indivkiual 
applk^ation whether Java® (a registered trademarit of Sun Microsystems. Inc.. Mountain View. California U.S. A.). Active 
40 X® (a registered trademark of Microsoft Corporation. Redmond. Washington U.S.A.). or CORBA® (a registered trade- 
wajk of Object Management Group. Inc., Rramingham. Massachusetts U.S.A.), without concern for how that application 
will integrate with other applications in the enterprise. Message brokers thereby t>ridge the gap between applications of 
the future and the disparate and complex products and technologies that cun-entiy exist in today's application cata- 
logues. 

45 [0030] While tiiere are many benefits to adopting a message broker strategy, it must be kept in mind that there are 
also potential pitfalls. The very strengths of the message brokering in terms of its loose coupling flexibility, may also be 
its greatest weakness. The nature of message broker software, as noted above, is very generalized. Because it is 
designed to handle so many cfifferent conditions, testing all possible end-to-end code paths is an insurmountable task. 
When undetected bugs exist in the software, messages may be lost, delivered twk;e or delayed. The damage from such 

50 "accidents" wouki be most keenly felt in enterpr^ where message brokers are used to integrate nvsskxi critical trans- 
action processing applications. In financial transactions, for example, the delivery of one single message could be worth 
millions of dollars, while at the same time its non-delivery or delayed delivery could result in the loss of millior^ 
[0031 ] A second risk to a ntessage broker irrplementation is the possibility that faeign applications will introduce 
unauthorized messages to the broker. This may also result in loss. For example, in ttie banking industry, counterfeit 

55 messages couk) be published and thereby cause the withdrawal or misappropriation of funds. 

[0032] A ttiird risk of message broker implementation is the classical, "single point of failure." Message brokers of 
the prior an are typfeally implemented in a "hub and spoke' architecture. This means that the majority of message traffic 
passes through a few central hut>s. In the event of an outage or a physical cfisaster to one of those hubs, the mission 
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critical operations of a fcx^'ness could come to a grinding haft. 

[0033] Another problem with distributed hubs is the difficulty of managing the message broker complex. Because a 
message broker integrates so many different bi^ess applicators into a few consolidated hite. the talent and exper- 
tise required to manage and administer a message broker complex may be unattainabla 
5 [0034] The potential r^ exposure is large whenever technology is applied to mission critical transaction processing 
appOcations of an enterprfea One problem for message brokering is that it manipulates ntission aitical information. In 
relative terms, message brokering is fairty new. However, while some eariy adopter companies have had great success 
with the concept of message brokering, much wore is needed before message brokers and EAl can enter the main- 
stream. 

10 [0035] In the 1 980's software systems development concentrated on the ability of heterogeneous systems to com- 
nruimcate with each other. This was. in large part due to the proliferation of proprietary communication protocols. Any 
newly developed system had to either conply with the application and data formats in place for the systems with whk:h 
it wished to connect or communicate, or provide such application a specific translation. Accordingly, all software was 
customized to a greater or lesser degree. 

IS [0036] In toda/s rapidly changing environment the concerted efforts of thousands of developers woridwide are 
focused on developing a system that satisfies the need tor disparate applications to conununicate with each other, with- 
out the necessity of enrt>edding multiple, customized application-specific translation schemes. TTiis as yet unfulfilled 
need is grounded in the irrperative of the global economy. 

[0037] Accordngly, it is a general object of the present invention to provide systems and methods for integrating 
20 enterprise applications, which at the same time provide comprehensive management of such enterprise applications, 
indudirtg centralized monitoring, operation and configuration. 

[0038] It is a more specific object of the present invention to provide an agent-adapter architecture and message 

schema, which together improves message tracking and manipulation in such systems and methoda 

[0039] Another object of the present invention is to provide in such systems and methods enhanced secuity fea- 

25 tures, including such aspects as authentication, authorization, privacy, non-repudiation, and auditing. 

[0040] Still another object of the present invention is to provide systen^ and method for integrating enterprise appli- 
cations that include means for disaster recovery, fail-safe rollover, message replay and dual^e logging. 
[0041] It is also an overall object of the present invention to fadlitate fast and simple integration of leading ERP 
applications, custom/legacy applrcations. packaged applications, arxi databases. More specifrcally. it is also an object 

30 of the present invention to reduce or substantially eliminate the need for the expensive custom coding ttiat is tradition- 
ally required to integrate applications. 

[0042] Another object of the present invention is to provide an EAl system, which has a distributed architecture that 
fadfitates the long-term reliabiiity. scalability, f lexbility, and extensibility needed by today's enterprises. 
[0043] Still another object of the present invention is to provkie an EAl system. whk:h increases an enterprise's 
35 retum on investment by enabling the enterprise to leverage its existing FT investments, increase Hs speed to market, 
implement solutions and realize benefits nrv>re quickly, and reduce its operational costs. 

[0044] Yet another object of the present invention is to prcvkie an EAl system, which provkJes faster access to an 
enterprise's customer and billing information so that the enterprise can servk:e its o^omers more effectively and effi- 
dentiy, aeating stronger, more effective relationships. 
40 [0045] A further object of the present invention is to provide an EAl system witii many-to-many points of integration, 
which substantially eliminates the concerns of conventional hut>-and-spoke systems and their singleix>int-of-failure 
risks. 

[0046] Still a further object of the present invention is to provkie an EAl system, which simplifies an enterprise IT 
architecture by provicfing a central point of integration for virtually all applications and platforms. 
45 [0047] Yet a further object of the present invention is to provkJe an EAl system, which provMes effk;ient and cost 
effective information sharing. 

[0048] The mettiods, apparatus, and articles of manufacture descrO^ed herein will achieve tiie above and other 
objects, advantages, and novel features accorcfing to the present invention, while avoiding the problems descnl^ 
herein above. 

50 [0049] In accordance with one important aspect of the present invention, the method comprises computernmple- 
mented means for passing messages between a first computer application and a second computer application. Such 
method generally includes the steps of: (a) providing a first message having a first data structure from the first computer 
application: (b) publishing the first message to obtain a first published message: (c) converting the first data structure 
of the first published message to a second data structure to obtain a second message; (d) publishing the second mes- 

55 sage to obtain a second published message; and (e) providing ttie second published message to the second computer 
appDcation. 

[0050] Accorcfing to another important aspect of the present invention, the apparatus conprises a system for inte- 
grating a plurality of computer applications Such apparatus generally includes means for routing messages within the 
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sy^em; means for storing a plurality of data transformation cx)nfigurations and a plurality of rules; means for applying 
the data transformation configurations to messages: mear^ for applying the rules to messages; and means for routing 
messages between the means for routing messages within the system and the computer applications and having ded- 
icated means for routing messages for respective computer applications. 

[0051 ] Alternatively, the apparatus of the present invention conprises a sy^em for integrating a plurality of compu- 
ter appGcations. Such system generally includes an enterprise messaging system that passes messages between the 
computer applications; a database storage system, coupled to the enterprise messaging system, that stores a plurality 
of data transformation configurations and a plurality of rules; an integratbn service, also coipled to the enterprise mes- 
saging system and comprising a data transformation engine i^ng the data transformation configurations stored in the 
datat)ase storage system and a rules evaluation engine using the rules stored in the database storage system; and a 
plurality of agent-adapters, further coupled to the enterprise messaging system with each agent-adapter coupled to a 
respective one of the computer applications to pass messages between the enterprise messaging system and the 
respective conputer application. 

[0052] In accordance with still another important aspect of the present invention, the article of manufacture com- 
prises a computer-readable medium emtxxiying code segments for integrating a plurality of computer applications. 
h4on-limiting examples of such "computer-readable medum" in this regard include any; magnetic hard disk; floppy disk; 
optical disk. (e.g.s a CD-ROM, a CD-R. a CD-RW, or any disk compliant with known DVD standards); magnetoK)ptical 
dtski magnetic tape; memory chip; carrier wave used to carry computer-readable electronic data, such as are used in 
transmitting and receiving e-mail or in accessing a network, including the Intern^, intranets, extranets, virtual private 
networi^ (VPN), local area networks (LANQ, and wide area networks (WAI^; or any other storage dence used for stor- 
ing data accessible by a computer. Non-limiting examples of such "code segments" include not only source code seg- 
ments and object code segments, but also computer programs in any language, instructions, objects, software, or any 
means for controlling a computer. Such code segments generally include: (a) a first code segment for passing mes- 
sages between the computer applications; (b) a second code segment for perfomrvng data transformation of messages; 
(c) a third code segment for applying rules to messages; and (d) a plurality of fourth code segments, each of which 
passes messages between respective computer applk^atfor^ and the first code segment 

[0053] In accordance with yet arrather irrportant aspect of the present invention, the systems and methods are 
directed to a computer. Non-limiting examples of a "computer" include any: general purpose computer; mainframe; PC; 
web browser; e-mail dient; e-mail server; network fOe or messaging server; Internet appliance; wireless telephone; 
pager; personal digital assistant (PDA); fax machine; digital still or video camera; c£gital voice or video recorder; digital 
copier or scanner; Interactive television; hybrid combination of any of the atxTve computing means and an interactive 
television; or any other apparatus comprising a processor, memory, the capability to receive input, and the capability to 
generate output. 

[0054] Other novel and equally important aspects of the present invention will become more apparent from a 
detailed description thereof, when.considered in conjunctfon with the following drawings wherein: 

Rg. 1(a) depicts an enterprise applrcation integratfon (EAI) system according to the present invention, as it is incor- 
porated within an environment inducBng legacy systems, packaged software applications, and relational database 
management systems; 

Fig. 1(b) illustrates a first scenario in which the system that is shown in Fig. 1(a) is used to integrate an enterprise 
resource planning (ERP) packaged software applk;ation with o^tom legacy systems: 

Rg. 1 (c) illustrates a second scenario in which the system that is shown in Rg. 1 (a) is used to integrate two or more 
disparate ERP pacteged software applications; 

Rg. 1(d) illustrates a third scenario in which the system that is shown in Rg. 1(a) is used to integrate one or more 
front-off k;e packaged software applications with one or more back-office packaged software applicatfons; 
Rg. 1(e) illustrates a fourth scenario in which the system that is shown in Rg. 1(a) is used to integrate data ware- 
house software applications using two or more disparate relational datat>ase management systems (RDBMS) or 
rrujtti-dimensional database management systems; 

Rg. 2 is a block cfiagram of the EAI system that is shown in Rgs. 1 (a) through 1(e); 
Rg. 3 depicts an adapter development kit used in the system that is shown in Rg. 2; 

Rg. 4(a) illustrates a basic agent-adapter architecture that is useful in accordance with a first emtxxjiment of the 
present invention: 

Rg. 4(b) illustrates an extensible agent-adapter architecture that is useful in accordance with a second embodiment 
of the present invention; 

Rg. 4(c) is a block diagram illustrating a presently preferred embodiment of an agent-adapter according to the 
invention; 

Rgs. 5(a) through 5 (c) illustrate design and integration objects used in the system accorc£ng to the present ; 
Rg. 6 illustrates a message schema used in the system according to the present invention; 
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Fig. 7 shows a other objects aocording to the present invention; 

Fig. 8 illustrate a typical trar^fornDation process used in accordance with the present invention; and 
Fig. 9 further Qlustrates the transformation process shown in Fig. 9; 

Figs. 10(a) and 10(b) illustrate the advantage of message hubs accorcf ng to the present invention; 
5 Figs. 11(a) through 11(c) depict various operating environments in which nodes and services according to the 
present invention are managed; 

Fig. 12 is a block diagram illustrating system services according to the present invention; 

Fig. 13 a flowchart illustrating the steps necessary to create a message in accordance with the present invention 

without converting raw data; 

10 Fig. 1 4 is flowchart illustrating the steps necessary to create a message in accordance with the present invention 
by converting raw data; 

Fig. 15(a) Qlustrates one method of creating a message from an application to a message instance in accordance 
with a f ir^ errtxxjiment of the present invention; 

Fig. 15(b) illustrates one method of creating a message from an application to a message instance in accordance 
15 with a second embocfiment of the present invention; 

Fig. 15(c) illustrates one method of creating a message from an application to a message instance in accordance 
with a third errtxxfiment of the present invention;; 

Fig. 15(d) illustrates one method of creating a message from an application to a message instance in accordance 
with a fourth errbodim^ of the present invention; 
20 Fig. 1 6 is a first dass cfiagram according to the present invention; and 
Fig. 1 7 is a second dass diagram according to the present inventioa 

The Enterprise Confuting Runtime Environment 

25 [0055] Referring now to the drawings, wherein like reference characters or numerals designate like or corresporxi- 
Ing parts throughout each of the several views, there is shown in Rg. 1 (a) a simplistic view of an enterprise corrputing 
runtime environment 10. Typical runtime environments 10 use a plurality of packaged software applications, tnduding 
"back-office" appfications 20 for enterpr^ resource planning (ERP) and tront-off ice" applications 30 for customer rela- 
tionship management (CRM), one or more customized legacy systems 40, arxl one or more rruilti-dimensional/rela- 

30 tional datat>ase management systems (RDBMS) 50. 

[0056] Throughout the past few decades, business enterprises have designed or txxjght many large, single-pur- 
pose software applications. These "legacy" applications continue to be vsed, and most often were designed to perform 
a specific functkHi (e.^., inventory, finance, accounting, sales force automation, and human resources). More recentiy. 
sut>stantial investments have also been made by those same enterprises to procure packaged software applications 

35 from software devek)pers such as SAP. PeopleSoft, Orade. arxJ Baan. Each of these packaged software applications 
enjoyed its own unique strengtf^ Accordingly, the typical business enterprtee used two or rTX)re disparate packaged 
software applications in the same runtime environment Such packaged software applications were not. in the begin- 
ning, designed to share information among themselves. As a result, enterprises had been forced to inte^ate their dis- 
parate packaged software applications with expensive custom coda Such integration efforts often took monttrs. if not 

40 years, to complete. 

[0057] Enterprise application integration (EAI) systems, such as the system 100 shown in Rg. 1(a). therefore, 
(became a necessity. However, unlike EAI systems according to the prior art, system 1 00 comprises a solutions-oriented 
middleware, which fadlitates its users to modify and fully integrate information residing within disparate applications 
through a single, corrunon infrastructure. It albws the user to move information seamlessly, transparentiy. arxi quickly 

45 among employees, customers, and suppliers, to achieve maximum productivity. 

[0058] In such a manner, system 1 00 provkies a reliable ^e-and-fonward messaging system, a capatsle mess^e 
brokering facility, and a strong agent-adapter architecture for integrating disparate enterprise applications. It is adapted 
to be dstrOxited, and ts designed for easy administration and management It \s targeted to meet the complete, heter- 
ogeneous corrputing requirements of a large organization. It Intel ligentiy links various applications so they can access 

50 and share information. It is middleware that adapts to applications, rather than fordng applications to adapt to it 

[0059] System 100 solves most EAI problems by enabling its users to link ERP applications 20. packaged applica- 
tions 30. custom and legacy applications 40. and datak)ases 50 throughout the enterpr^, with minimal custom coding. 
When fully integrated, an enterprise can quiddy synchronize global businesses and (^visions and respond to ever 
dian^ng market demands. With faster access to customer and tilling information, the iter's organization can service 

55 customers more effectively and effidentiy, creating stronger, more effective relationships. System 100 is a business- 
centric enterpr^e integration solutfon, witii an integration flow design environment tfiat targets the business analyst. 
The analyst defines the problem in txisiness terms, and the product hartdles the technk:ai issues. 
[0060] For example, as shown in Rg. 1 (b). the common scenario of enterprise resource planning (ERP) integration 


7 


EP1 016989 A2 


with custom legacy syst^ns demands that the organization encapsulate complex processes property within standard 
ERP Implemerrtations — not an easy thing to da Many corporations choose to implOTent packaged applications for 
starxJard business processes such as inventory and onjer management But packaged applications are seldom used 
for vertical processes. For these purposes, the system 100 is Ideal, tt provides object interfaces for the ERP systems 

5 22. 24, 26, 28. as weD as wrapper-generation technology for linking to legacy systen^ 44. 48. 

[0061] The extension of the global supply chain also requires that nvddleware bridge two or more disparate ERP 
systems 22. 24. 26. 28. As illustrated in Rg. 1(c), it can be readly appreciated that nothing may be more inrportant to 
a business-to-txjsiness collaboration. The system 100. thus, plays a k^ role by enabling inter-ERP transactions in 
which business Brents in one system (e.^., SAP system 22) invoke corresponding events in another system {e.g,, Baan 

10 system 28) without exposing the details of the underlying technology. 

[0062] Integration of a corporation's *tront-off ice" with its t)ack-off ice* is an important functk>n. which allows front- 
office applications that interact with the customer to collaborate with back-end production applicatior^ For example, 
and referring now to Rg. 1(d). it is critically irrportant that customer-support systems collatxxate with ERP inventory 
modules. System 100, thus, ^cilitates integratk>n of bestK}f-t>reed front-office and t>ack-office applk:atk>ns seamlessly 

IS and transparently. 

[0063] In the data warehouse scenario as shown in Rg. 1 (e). data from disparate systems ntust nugrate to a central 
data warehoi^e or repository. Moving real-time information from several ERP systems (not shown in Rg. 1 (e)) to a cer>- 
tral relational or muHiKlimensional database containing a plurality of different databases 53. 56. 59 ^ exemplary of this 
problem However, data warehouse developers can leverage the data translation services of system 100. as is 
20 descrik>ed in greater detail herein below, for real-time data aggregation or other operations. Data te. thereby translated 
into an understandat>le and meaningful condition. 

D efinrt iQ ns 

26 [0064] As used hereinafter, the following terms should be construed t>y those of ordinary skill in the art in accord- 
ance with their ordinary and accustomed meaning. To the extent the definitions, wfvch appear herein k>elow. differ from 
othenvise conventional definitions known to those of ordinary skill in the art. it shouki t>e appreciated that such terms 
are hereinafter dearly set forth in such a manner to put one reasonably skilled in the art on notice that the applicant 
intended to so redefine that daim term. 

30 [0065] An "accessor is a function specified in message definitk>ns that tfie system 1 00 uses to access data. Aoces- 
sors identify the start and end of applk^ation data fields and system message elements, and remove or insert markers. 
[0066] "Adapter iiiplementatbns" are code designed for a specific application that can extract data arxi produce 
system messages; rec^ve system nrtessages arxl update data; or extract data in response to requests. When the user 
creates an adapter to use in an integration f k3w. the user builds it around an adapter innplementation. System adapter 

35 implementations provide basic exception harvlling and can handle any message definition. A user aeates custom 
- adapter implementations using an ADK as defined and described in greater detail herein t>elow. 

[0067] "Adapters" are integration flow ok^ects that interact with enterprise applk:ations to extract data or insert, 
update, or delete data. 

[0068] The "administration console" a graphical user interlace (GUI) through which a system administrator con- 
40 figures and manages the nodes and services of system 1 00. 

[0069] "Agent services" provide system servces to the adapters. An agent service is required on each host that 
runs an adapter. 

[0070] A "dasspath" is an environmental variable that tells the Java virtual machine where to find the dass IS)raries. 
including user-defined dass Ibraries. 

45 [0071 ] "Clients" are processes that remotely access computer server resources, such as compute power and large 
memory capacity. Typical system dients are the integratk)n workt}ench 120 and the administration console 160 (Rg. 2). 
[0072] A "connectk)n" is an object that specifies startup or connection parameters for adapters. For example, an 
RDBMS connection specifies the JDBC driver, the URL of the database, the user name, and password. 
[0073] "ConverT data is a process in which converters specified in message definitions convert an application's 

50 native data types to the Java data types the system 1 00 sipports. and vice versa. 

[0074] A "converter" is a function specified in message definitions that system 1 00 uses to convert data. In such a 
manner, converters convert native data types to the Java data types tfiat the system 100 supports, and vice versa. 
[0075] "Custom adapter implementations" are code designed for a specific application tfiat can: either extract data 
and produce system messages; receive system messages and update data; or extract data in response to requests. 

55 Custom adapter inplementations. created using the ADK. can conned to applications the system 100 does not cur- 
rently support. 

[0076] A "def initk>n objecT is an integration flow object that provides instructions for a process that the system is to 
implement 
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[0077] "Delimrters" are tokens or markers that separate data f ie!(te in data from enterprise applications. 
[0078] A "durat)le subscription' is a property of the system's message hubs that ensures the hub target objects 
receive all messages intended for thera a target object becomes inactive, the sy^em remembers those messages, 
which the target has received. When the target next becomes active, the system delivers messages the target has not 
5 yet received. 

[0079] "Enterprise applications" are applications from which adapts extract data or to which adapters propagate 
data (e.g., SAP R/3 or MQSeries). 

[0080] An "Enterprise Messaging Service (EMS)" according to thte invention is implemented using the Java Mes- 
saging Service (JMS). It enables system 100 to use multiple messaging modes, and supports message hubs and pro- 
10 vides message persistence. 

[0081] "Enterprise Resource Planning (ERP)" applications provide a tumkey solution {e.g., warehouse manage- 
ment, human resource management, and materials management) for common business problems. Examples of ERP 
products are SAP R/3. PeopleSoft, and Baan. 

[0082] An "EntireX Broker (ETB)" is a cross-platform, message-oriented middleware accorcfing to this invention. 
75 which links mainframe. Windows NT, and UNIX applicatior^ and components. Internet and intranet dients. and 
ActiveX- and Java-enabled workstations. 

[0083] "RIter d^nitions" are definition objects that specify criteria for screening messages out of integration flows. 
[0084] A functions host" Is a computing platform, such as a Windows f4T server or wori^tion. or OS/390 main- 
frame. 

20 [0085] "Hut>s' are integration f k)w objects that receive messages from source objects and hold the messages until 
the system 100 delivers them to specified target objects. Hut>s allow adapters and transformers to exchange messages 
asynchronously. They are also useful for concentrating message fk>ws; multple objects that produce the same kirKi of 
message can all send those messages to one message hubi which simplifies links among objects 
[0086] An "IDoc Extractor" reads flat files produced by the SAP R/3 transaction WE63 to create implementation 

25 configurations and message definitions and stores them in the system's repository service. 

[0087] "Implementation settings" are runtime parameters for adapters (e.^., a polling interval). 
[0088] An "integration flow" is a series of linked system objects that move data from one or more enterprise appli- 
cations to other enterprise applications. 

[0089] "Integration objects" are integration flow objects, which send messages, receive messages, or both. See. 
30 e.g., adapters, hut)s. and transformers. 

[0090] An "integration workt)ench" is a graphical user interface (GUI) through which a user designs integration 
flows. 

[0091] "Intermediate documents (IDocs)" is an SAP R/3 data format used by R/3 to exchange data with other R/3 
systems and with other applications. 
35 [0092] An "item message elemenT is a message element that contains data. Items are the lowest level message 
elements in the hierarchy of the message definition. Th^ cannot contain other message elemerrts. 
[0093] "Java Database Connectivrty (JDBC)" is the Java API standard for SQL-t}ased datat>ase access. 
[0094] A "Java Devek)pment Kit (JDK)" is a software development environment for writing applications in the Java 
programming language. 

40 [0095] "Java Message Service (JMS)" is a Java API specified by Sun Microsystems fa messaging. 

[0096] A "Java framing and Directory Interface (JNDI)" is a set of APIs tiiat assist with ttie interfacing to multiple 
naming and directory servk^es. 

[0097] "Java Runtime Environment (JRE)" is a sut}set of ttie Java Development Kit used to redistribute the runtime 
environment consisting of the Java virtual macNne, Java core classes, and supporting f 3es. 
45 [0098] A "Java virtual machine (JVM)" is part of the Java Runtime Environment responsible for interpreting byte- 
codes. 

[0099] "Link mari^" are tokens or delimiters that separate data fields in data from enterprise applications. 
[01 00] A "message definition category" is a togical grouping for message definitions. 

[0101] "Message definitions" are d^inition ot)jects. whk^h kientify data system 100 Is to extract from a propagate 
50 to an enterprise application. Message definitions also define how system 100 is to construct system messages from 
enterprise appfication data or create enterprise application data from system messages. 

[0102] A "message elemenT is a data object that makes up the message schema of a message definition. Mes- 
sage elements are arranged in a hierarchical stnicture. and can be sections, tables, or items. 
[01 03] "Message-Oriented Middleware (MOM)" is software that uses messages to enable applications on the same 
55 or differerrt platforms to communicate. Communications protocols are hidden from the applications. Examples of MOMs 
are MQSeries, EntireX Broker, and JMS. 

[01 04] "Message persistence" relates to the storing of messages onto recoverable media. The system writes each 
message it delivers from one integration object to another to stable storage in a location tiie user specifies. If a system 
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failure occurs whfle a message ts in transit, system 100 can retrie/e the message from storage wtien the system 100 is 
restored and deliver the message to its targets. 

[01 05] A "nriessage schema' s that part of message definitions, which define how to dructure a messaga Message 
schemas can include section, tat)le, and it^ message elements arranged in a hierarchical structura 
5 [0106] "Monitor services' ^e system runtime data, inducfing system logs and stattetics information. 

[0107] A "node" is a physical process (or Java virtual machine) that supports one or more system and application 
services. 

[0108] "Node hosts" are software than enatiles the user to configure and run nodes on a machina The i^er nrtust 
install a node host on every machine, other than the node manager, that will host a node. 
10 [0109] A "node manager" is an interlace through which nodes are managed. The Interface allows the user to con- 
figure, start pause, or stop a service. Node managers start and stop nodes as wefl. The node manager maintains the 
state of all of the services that are d^txjted to the nodes. In addition, the node manager maintains status information 
(e.^.. current state or activity leveQ of a node or service. 

[0110] "Point-to-point messaging' Is a messaging style for hubs in which the system delivers each message that 

75 arrives at the hub to a single hub target only {i.e., the first available target 

[01 1 1 ] A 'primary input message' Is the main input data to the system trar^rmation processes specified in trans- 
former definitions. The system takes input data, transforms it. and aeates output data needed by target applications. 
[0112] "Publisfi/subscr&>e messaging" is a messaging style for hubs in which the system delivers each message 
that anives at the hub to all hub targets. 

20 [01 1 3] A "replier" is a sy^em object, such as a reply adapter, which provides data when transformers request It dur- 
ing the data transfomnation process. 

[0114] "Reply adapters' are integration objects tfiat reply to requests for data from other integration objects t>y 
extracting the data from applications and sending it to the requesting objects. Requesters send sy^em messages con- 
taining data in key message elements, and the reply adapters insert data into related message elements and send the 
25 system messages back. 

[01 1 5] A 'repository service" is interfaced via Java Native Directory Interface, and stores configurations for alt con- 
figured services and Integration flow objects. 

[0116] "Routing services' enable the system to direct messages through the system based on a message's con- 
tent, including filtering message content aocorcfing to criteria the user define. The routing service supports filters. 
30 [01 1 7] A 'system message" ts a message, In platform-neutral format, that the system uses to nrvsve data from appli - 
cation to application. 

[0118] "Section message elements" are non-repeating groips of nrtessage elements that do not contain actual 
data. Th^ contain other message elemerrts that contain data {Le., they contain Iten^). Sections can contain any com- 
bination of message element types. 
35 [01 1 9] A "service' is a process that provides product functionality. The system Is n^e. isp of.system, messaging, 
integration, and agent services. 

[0120] "Source adapters" are integration objects that extract data from enterprise applications, construct system 
messages from the data, and send the nrtessages to other the system integration objects. 

[0121] A "source objecT is an inte^ation ftow objects that provides messages to other objects. Sea eg., source 

40 adapters, transfbmiers. and hut)s. 

[0122] "Supporting input messages" are optional input data to the system transformation processes, as specified 
in transformer definitions. Transformation processes use supporting input message data to supplement primary input 
message data. The system takes input data, transforms it and creates output data needed by target applications. 
[0123] A "table message element' is a group of section message elements, called rows, that can repeat any 

45 number of times. Tat)le elements do not contain actual data. Instead, they contain other message elements that contain 
data (/.&, th^ contain items). Tat)les can contain any combination of message element types. 
[0124] "Target adapters' are integration objects that receive system messages from other integration objects, cre- 
ate application data from the system messages, and propagate the data to target applications. 
[0125] A larg^ integration objecT is an integration flow ot)ject tfiat receives messages from other otijects. See. 

50 e.g., target adapters, transformers, and hite. 

[0126] Trar^ction Processing Monitor (TPM)" Is a software system designed to optinuze use of computing 
resources, such as storage and applications, for many users. 

[01 27] To "transfonn data' is a process in which transformers nxxJify data taken from one or more enterprise appli- 
cations into data needed by other enterprise applications. 
55 [0128] *Transtormation sendees' enable the system to transform messages, inducfing splitting messages, combin- 
ing messages, and manipulating message data The transformation dervice supports transformers. 
[0129] A "transformation step" is a conrvnand that makes up the transformation process. Each step either reads 
input message data, transforms and ntaps input message data to output message definitions, or writes transformed 
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data to output messages. 

[01 30] Transformer def inftjons" are definition ot^ects that define how the system is to transform system messages 
extracted from one or nrxxe enterprise applications into system messages needed by other enterprise appBcatior^ 
[0131] A "transformer** is an integration object that implements transformer definitions. Transformers gather input 
5 messages from source integration objects, transform the content and format of the message data, and produce and 
send output messages to target integration objects. 

[0132] 'User interface services (UlS)' provide the i^er interface facilities necessary to run the client components 
(Le., the Integration worM>ench 120 and the adminstration console 160). 

[0133] Refening now to Fig. 2. system 100 generally comprises a plurality of design components 1 10 and a plurality 
10 of runtime management components 1 50. The design components 1 1 0. in turn, more specifically comprise an integra- 
tion wrkt>ench 120. an adapter development kit (ADK) 130, and a repository service 140. The runtime management 
components 1 50. in tum, more specifically comprise an admin^tration console 1 60, an integration server 1 70, Including 
an enterpr^ messaging engine 180. a node services oorrponent 190, a plurality of intelOgent agent-adapters 200. 
[01 34] The integration workt>ench 1 20 generally comprises a graphical modeling arxi configuration tool for integra- 
ls tion project development. It is used to define events, those mess^es associated with such events, integration flows, 
and business rules associated with such integration flows, as well as to identify those agents that publish and sut>scrfoe 
to the defined events. In addition, the integration worM>ench 120 provides diagnostics for consistency checking and 
testing integration flows. 

[0135] The ADK 130 is used to configure and g^erate customized intelligent agent-adapters 200. Shown in 
20 greater detail in Fig. 3. ADK 130 generally comprises an object framework including dass libraries 132. wizards 134. 
and tenrptates 1 36. The ADK 1 30 generates objects tfiat can be accessed from conventional development tods. While 
system 100 indudes a plurality of standard intelligent agent-adapters 200 for a wide range of applications and 
resources, there may be specific applications for wNch there is no such standard irrtelligent agent-adapter 200. In that 
event ADK 130 further permits a custom, intelligent agent-adapter 200 to be built by tfiose devdopers wtio are more 
25 familiar with the published interfaces that are provided by the target application environment. 

[0136] The repository service 140 generally oorrprises a relational database, which contains all of the specifica- 
tions for system 100, meta-data. and message broker service rules, and an interface to that relational datat>ase. 
[0137] The administration console 160 is used to configure and manage the runtime environment of system 100. 
and generally comprises a graphical consde. It serves as a confrd pdnt for system configuration, maintenance, mon- 
30 itoring, and dagnostics. Through the administration console 160. each of the individual components of system 100 are 
managed, induding comprehensive services such conrponent initiation and terminatioa and built-in software distribu- 
tion. 

[01 38] The integration server 1 70 irrplements intdligent messaging by triggering and executing integration f kTws to 
process events. It executes static and dynamic context sensitive rules that evaluate, modify, and route event data. As 
35 noted herein above, integration server 1 70 indudes the enterprise messaging engine 1 80 comprising a dstributed mes- 
saging sut>system. which manages all event data. It is. on the one hand, a key component of system 100. On the other 
hand, it is largely trar^parent to any user of system 1 00, and generally operates behind the scenes. H supports full per- 
sistence. oncenarKl-onty-or)ce message delivery, and an in-memory rrxxie for non-critical, high vdume message 
requirements. 

40 [01 39] The node services component 1 90 mariages startA^estart recovery, exception handling, and dynamk; config- 
uration of system 100. It provides fadlities for automated system installation and remote managerrierTt aaoss all partic- 
ipating dients and servers. Moreover, it is readily capable of installing and updating components renK>tely. 
[0140] As noted herein above, the plurality of intelligent agent-adapters 200 indude not only those standard intelli- 
gent agent-adapters 200 that are debuted with system 1 00. but also those custom intdligent agent-adapters 200 that 

45 are developed ADK 1 30. Each such intdligent agent-^apter 200. regardless of its type, generally corrprises a runt- 
ime interface module connecting a particular one of the external application resources 300 to sy^em 100. 
[0141] Referring for the nfK)ment to Rgs. 4(a) and 4(b), it may be appredated that such intdligent agent-adapters 
200. in accordance with a particularly important aspect of the present inverrtion, combine the functionality of autono- 
mous agents with adapter technofogy. The agent conrponent 210 acts as an independent software process, which 

so hosts one or more adapter corrponents 220 (Rg. 4(a)). or 222 and 224 (Rg. 4(b)). It encapsulates sophisticated func- 
tionality such as store and fonward caching, filtering, resource pooling, and scheduling. 

[0142] A primary advantage of this agent-adapter architecture is its at>ility to host conplex budness logic in order 
to maintain state and negotiate transactions with the application resources 300. This ability may be thought of as "con- 
versational mode processing", which is particularty critical when integrating application resources 300 of a transactional 
55 nature. More often tfian not. data elements ttiat may be required for brokering messages from such applk:ation 
resources 300 are deeply nested within sul>-tran5actions. These deeply nested data elements can. thus, be obtained 
only by engaging in a conversation with the transactional application resource 300. Othenwise "primitive" adapters, 
which have been used in the past do not adequately address the complex behavior of transactional application 
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resources 300. 

[0143] As shown in Fig. 4(a). a typical intelligent agent^adapter 200 according to the present Invention includes an 
agent conponent 210 and an adapter component 220. On one side of this architecture, the agent 210 contonr^ to a 
specified event and messaging model of the system 1 00. Adapter 220. on the other side of this ^ent-adapter architec- 

5 ture. uses a native application programming interface (API) 510 of a particular application resource 300. or other suita- 
t)ly put)(ished interface mechan^. Together, agent 210 arxJ adapter 220 mediate differences in interface protocol and 
data structures to provide a uniform, normalized view of the txistness events that they publish and consuma 
[0144] UnOke past approaches to EAI. the foregoing agent^adapter architecture Is extensible. It ntit only facilitates 
an at)ility to seamlessly accornnriodate chariges to existing APIs, but it also 

10 APIs with legacy systems. Shown nxxe dearly in Rg. 4(b), this extensQsle agent-adapter architecture generally com- 
prises an agent 210 encapsulating a first adapter A*222 and a second adapter A**224. 

[0145] Adapter A*222. for exanrple. corresponds to an application resource 300 having a basic set of APIs A'. On 
the other hand, adapter A**224 corresponds to the same application resource 300 having a newer set of APIs A". Users 
of such an extensible agent-adapter architecture may thereby choose to simultaneously adapt to both interfaces A' and 

15 A". For example, the basic set of APIs A* may correspond to a production environment while the newer set of APIs A" 
may correspond to a pre-production environment of a newer version of a particular appGcation resource 300. The newer 
set of APIs A" could, thus. t>e tested live" within system 1 00. at the same time that the t>asic set of APIs A* will be used 
to maintain previoi^ly tested and proven functionality. In such a manner, this extensible agent-adapter architecture ena- 
bles perfectly seamless negotiation of incremental changes to the application resource 300 into the integration environ- 

20 ment. 

[0146] Refemng now to Rg. 4(c). there is shown a greatiy enlarged view of an agent-adapter 200 according to a 
presentiy preferred embodiment of the invention. Uke the agent-adapters shown in Rgs. 4(a) arxi 4(b). the agent- 
adapter 200 shown in Fig. 4(c) is used to convnunicate between the system 1 00 and the native API 51 0 of an enterprise 
application (not shown). TTie agent-adapter 200 according to this embodiment, however, includes three adapters 222, 
25 224, and 226. As described in greater detail herein t>elcw. adapter 222 is of the source adapter variety, adapter 224 is 
of the target adapter variety, and adapter 226 is of the reply adapter variety. It may be readly appreciated to one of ordi- 
nary skill in the art. therefore, that the agent-adapter 200 according to this enixxliment of the present invention is not 
limited to any given number of specifically-directed adapters which may t>e erK:apsulated by agent 210. For example, a 
request adapter 228 (not shown in Rg. 4(c)) of the type described in greater detail herein below may be used in con- 
so junction with or in sut>stitution for those adapters 222, 224, or 226 as shown. 

[0147] Moreover, according to another particularly important aspect of the present invention, agent 21 0 corrprises 
a plurality of objects 230-240 useful in extending the abilities of agentnadapter 200. For example, object 230 presentiy 
comprises a transformation object whk;h fadlitates performance of otherwise centralized functions of system 100 
locally within the agent-adapter 200 itself. Object 231 similarly corrprises an error management object, object 232 a 
35 connection management object, and^ object 234 a rules managenr^ object. Further extensblity of agent-adapter 200 
Is only lirrvted by the nurTt>er of additional objects 235-240 that may t>6 co-located with the agent 210. 
[0148] The foregoing is a particularly intportant aspect of the present invention, since it fadlitates decentralization 
of the message handling aspects of system 100. Distrixited enterprise application integration is, therefore, assured, 
since the agent^adapter 200 according to this embodiment of the present invention may t>e associated with any node 
40 across the system 100. 

[0149] The manner in which system 100 shares data among enterprise applications is determined by integration 
flows, as will described in greater detail herein below. Typical integration flows use one a more system messages. Each 
of the system messages generally comprises a communicatioa in a platform-neutral format which moves selected 
data from one software applicatk>n to another software application. Integration f k3ws. in turn, are made up of a plurality 
45 of objects and links among tiiose objects. Each of ttie objects performs a specific task relating to the system messages 
that carry data from enterprise application to enterprise application. 

[0150] For example, and referring now to R^. 5(a) through 5(c), an object in an integration fkiw 540 comprises 
either a definition object 510 or an integration object 530. There are three basic types of definition objects 510, which 
may be used according to the present invention: (1) a message d^inition 512; (2) a transformer definition 514; and (3) 
50 a filter def viition 51 6. Definition objects 51 0 may be used repeatedly in any given integration flow 540. For example, tiie 
same message definition 512 must be assigned to all objects 510, 530 that will handle system messages produced 
using that message definition 51 2. Moreover, the same filter definition 51 6 may be used in multiple sections of an inte- 
gration flow 540. 

[01 51 ] The message definition object 512 identifies data ttiat tiie system 1 00 ^ to extract from or propagate 1 0 an 
55 enterprise application 541 . 549. It also defines how the system 1 00 not only will construct system messages from enter- 
prise application data, but also aeate enterprise application data from system messages. 

[0152] Transformer definition objects 514 define how the system 100 will transform system messages extracted 
from one or more enterprise applications into system messages needed by other enterprise applications. 
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[01 53] A fitter definition object 516 defines criteria that the sy^em 1 00 will to fitter unwanted system messages 
out of integration flows. In an integration flew that trarYsforms new custonrer data irrto invoices, for example, one fitter 
definition object 516 that might be useful would be one in which system messages about customers who have already 
paid would be f St^ed out. 

5 [0154] Integration objects 530. of wtiich there are three basic types, actually send or receive system messagea 
The three basic types of integration objects 530 are: (1) an adapter 220; (2) a message hub 518; and (3} a trar^fbrnrter 
520. Furthermore, and as noted briefly herein atxive. there are four basic types of adapters 220; (a) source adapters 
222; (b) target adapters 224; (c) reply adapters 226; and (d) request adapters 228. 

[0155] A source adapter 222 extracts the data from a source errteiprise application, constructs system messages 
10 from that data, and sencte ttiose system messages to other integration objects 530 {e.g., message hub 518). A target 
adapter receives system messages from other integration objects 530 (e.g,, transformer 520 through fitter definition 
object 516), creates application data from those system messages, and propagates that data to a target enterprise 
appOcation. A reply adapter 226 replies to requests for data from some other integration otsjects 530 by extracting the 
data from the applications, and then sending it to the requesting object 530. 
15 [0156] In general, message hubs 518 are used to receive system messages from one or more source integration 
objects 530. and to hold those system messages until the system 100 can deliver same to one or more target integra- 
tion objects 530. 

[0157] Transformers 520 are generally used to implement transformer d^itions in three steps. They first gather 
system messages from source integration objects 530 {e.g., message hub 518). After tfie gathering ^ep. they next 
20 transform the content and format of the data contained within such system messages. Th^ finally produce and send 
output system messages to target integration ot^ects 530 (e.g., target adapter 224). 

[0158] Message definitions 512 are the primary objects around which the integration flow 540 according to the 
present invention is built. When a user creates an integration flow, a message definition is assigned to every object 51 0, 
530 In that f fow. A message definition 51 2 not only identifies the Idnd of system message that the object 51 0, 530 is to 

25 handle, but it also defines the hierarchical structure or schema of that system message. 

[0159] For example, a message d^inition 512 nrujst t>e assigned to every source adapter 222 in the user's integra- 
tion flow 540. Each source adapter 222 knows what Idnd of message it is to produce, based on the message definition 
512 the user has assigned to it Adapters 220. hut)s 518. and fitters 516 handle just one message definition 512. Trans- 
former definitions 514 arxi transformers 520. on the other hand, are capable of harvjling multiple message definitions 

30 512, as inputs and outputs. 

[0160] Some applications can create the Java data types that the system 100 supports. In those cases, the source 
adapter 222 can extract the data types specified in its message definition 512 and store them directly in a system mes- 
sage Likewise, a target adapter 224 can retrieve the data types from a system message arxJ ir^ert them cfirectly into 
the application (e.g., a target enterprise application 549). Other applications use a well-defir^ message format to 

35 descrbe the layout of their native data. In those cases, the message definition 512 for a source adapter 222 must 
include instructions for creating Java data types from the application data. Similariy, the message definition 512 tor a 
target adapter 224 must include instructions for creating application data from the system Java objects. 
[0161] A special kind of message d^inition 512 is used by integration objects 530 to request data from other the 
system objects 510, 530. For example, message definitions 512 can also specify message validation criteria. System 

40 1 00 uses this criteria to determine whether system messages produced by adapters 220 and transformers 520 contain 
valid data {e.g., where the user includes a message definition 51 2 defining messages, which contains employee payroll 
information). The user, accordingly, may prevent inaccurate salary data from entering the system 100. If the message 
definition 512 contains an item element "Salary", for example, the user oouU then define validation criteria for the item 
stating that the message valid only when the value in "Salary" is a positive number. The user may organize related 

45 message definitions 512 into logical groups called message categories. Suppose, for example, that the user is integrat- 
ing three applications using tfie system 100. The user might group the messages in the user*s project into ttvee mes- 
sage categories, one tor each application. 

[0162] K should be noted at this juncture that the particular message schema 600 of a message definition 512 is 
made up of data objects, called message elements, which are arranged in a hierarchical structure as shown in Rg. 6. 

50 In general, a message schema 600 comprises one or nxxe sections 620. one or more tables 640, and one or nx>re 
items 660. Either a section 620 or a table 640 must appear at the top of message 600 hierarchy. 
[0163] A section 620 is a non-repealing group of message elements. Such section elements do not themselves 
contain actual data Instead, they contain other message elements that contain data {i.e., they contain rten^ 660). Sec- 
tions 620 can contain any coiTt>ination of message element types. 

55 [0164] A table 640 is a group of section elements, called rows that can repeal any number of timesw Table elements 
also do not contain actual data. They contain other message elements that contain data (/.e., they contain items). 
Tables 640 can contain any combination of message element types. 

[0165] An item 660 is a message element that contains data. Items 660 are the lowest level message elements in 
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the hierarchy of the message definition. They cannot contain other message elements. 

[0166] Each message definition 512 can contain criteria for vaGdating messages based on that definition. That ts, 
when the user defines a message definition, the user can spedfy criteria that data in individual message elements must 
meet for a message to be considered valid within the system 1 00. 

[0167] The user can specify validation criteria fa ail levels of a message. That Is, the user can specify criteria for 
message items within sections or within tables. The entire message either passes the vafidation criteria and continues 
through the flow, or does not pass and is discarded. H even one row of a table does not pass specified criteria, the entire 
message does not pass. The system 100 validates every message produced by an adapter 220 a transformer 520 
using the validation aiteria in the appropriate message definition. 

[01 68] Acteipters 220 connect with enterprise applications to extract or propagate data. Each adapter 220 produces, 
receives, or replies to messages using the message definition 51 2 the user assign to it The systm 1 00 provides stand- 
aid adapters 220 for the applicatior^ it wfll integrate. Each standard adapter 220. as noted above, is a source adapts 
222. a target adapter 224, a reply adapter 226. or a request adapter 228, and is designed for a specific agent service 
type. For example, for EntireX Broker, the system offers an ETB Standard Source Adapter and an ETB Standard Target 
Adapter. Standard adapters are generic. They prutnde basic exception handling and can handle any message defini- 
tion. If a standard adapter 220 does not include all code the user need to interact with an application (e.^., the user want 
to specify more detailed exception handling), the user can create a custom adapter 220 using the ADK 130. The user 
can also use the ADK 130 to create custom adapters 220 for applications not currentiy supported by the system 100. 
Likewise, the user can use the ADK 130 to create custom adapters 220 that connect to any application with a JAVA 
application programming interface (API). 

[0169] To use a standard or custom adapter 220 in an integration flow 540. ihe user must configure in to handle a 
specific message definition 51 2. The user can configure as many of each type of adapter 220 as necessary to handle 
all messages the user need to include in integration f bws 540. 

[0170] Source adapters 222 extract data from enterprise applications and produce messages that they send to 
other integration objects 530. Specifically, a source adapter 222: (1) polls for or is notified by its application of a partic- 
ular type of event that has occurred at the application (e.^., data on a new customer has been entered); (2) extracts the 
data relating to the event from the application; (3) using message definition instructions, constructs a system message 
from the data; and (4) produces a message and sends it to one or more target integration objects 530. 
[01 71 ] Target adapters 224 receive messages from other the system objects 51 0. 530 in integration flows 540 and 
propagate the message data to enterprise applications 541 . 549. Specifically, a target adapter 224: (1 ) receives system 
messages from one or more source integration objects 530; (2) using instructions from the message definition 51 2, cre- 
ates application data from tfie system message; and (3) propagates the data to the target application 549 by Inserting 
new data, updating data, or deleting data as appropriate. 

[0172] Reply adapters 226 extract data from enterprise applications 541. 549 when requested by integration 
objects 530 such as transformers 520. Specifically, a reply adapter 226: (1) receives a request message from an inte- 
gration object 530; (2) extracts the requested data from its enterprise application 541, 549; and (3) sends the data to 
the transformer 520 in a reply message based on the same message definition 512 as the request message. 
[0173] Request adapters 228, in conjunction with reply transformers 522. are used to extract data from enterprise 
applications 541 , 549 without specific requests from such applications. As shown in Rg. 7. tfiey r^eve information that 
they anticipate may be needed by an application object 710 making another request. Rx example, the request from 
application object 710 may be as simple as "I want to see customer shipping data." All data comprising such customer 
shipping data is pulled in anticipation, put in the same message definition of the request. arKJ "pushed" to the application 
object 710. Specifically, a request adapter 228: (1) receives a request message from an application object 710; (2) 
extracts the anticipated data either directly from another object 540 in the system 100, or with the assistance of a reply 
transformer 522, through ttie reply transformer 522; and (3) sends the data to the applicatk>n object 710 in a message 
based on the same message def inition 512 as the request message. 

[01 74] Adapters 220 are hosted by agent services as described in greater detail herein bek3w. Agent servk^es pro- 
vide information adapters 220 need to connect to their applications {e.g,, passwords and user IDs). The system 100 
offers agent services for every enterprise applicatbn it can integrate. That is. it offers an SAP R/3 agent service, an 
EntireX Broker agent servk;e. and so on. The system 1 00 also offers agent sendees for custom adapters the user create 
using the ADK 130. 

[0175] The user needs one agent service for each enterprise applkation the user wants to integrate using the sys- 
tem 100. For example, if the user wants to integrate three SAP R/3 syst^ns with one RDBMS. the user needs three 
SAP R/3 agent services and one RDBMS agent service. Each agent service hosts all adapters 220 for the enterprise 
application to which the agent connects. 

[01 76] Transformer definitions 51 4 define a process that transforms messages containing data extracted from one 
or more applications into messages containing data needed by one or more applications. Transformers 520 implement 
transformer definitions 514 by gathering input messages from source objects, transforming the data, and sending out- 
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put messages to target objects. 

[01 77] The transformation process defined in a transformer definition 51 4 always involves at least two kinds of mes- 
sages: tfie primary input message, and one or mae output messages, as shown in Fig. 8. The primary input message 
typically contains most or all of ttie data the user want to send in output messages to the target applications. Output 

5 messages contain data from the input messages, transformed as necessary for target applications. 

[0178] When the user aeates a transformer definition 514, the user first specffies at 805 the name of the primary 
input message. Then, at 810. the user identifies the message definition 512 that defines the messages the user wants 
to use as the primary input Any supporting input messages are then specified at 815. Next the user identifies at 820 
the message definitions 512 that define such supporting input messages. A single transformation process can produce 

10 any number of outputs. Accordingly, the user must specify those output messages at 825. and identify the message d^- 
initions 512 that d^ine the messages the user want to produce as outputs. 

[01 79] The user then creates, beginning at 835, a sequence of steps 840. 845, 850, 855. 860. 885 that define wh^ 
to read input data, how to transform the input data, how to map the input data from input message definitions to output 
message definitions, and when to write the transformed data to actual output messages. 

75 [0180] The user transforms ir^ data in any way necessary to create the output messages the user needs. For 
exarrple. the user may aeate a transformation expression that specifies concatenating ^ message item containing a 
customer's first name and a message item containing the customer's last name, because a target application requires 
the ci^tomer*s full name in one data field. The user creates a transformation expression that specifies selecting only 
certain cfiaracters from a message item, or padding a message item with spaces to make it the right length for the cor- 

20 responding data f iekl In the target application. The user then produces dfferent output messages by writing them at dif- 
ferent points in the transformation process. 

[0181] When the primary input message does not contain all data needed to produce the output messages, the 
user can obtain supporting input for the transformation process using request/^eply message d^initiona For example, 
suppose the primary input message the user is using in the transformer definition uses abbreviations for United States 
25 state names (e.g., VA for Virginia). 

[0182] Assume, for exarrple. that the target application requires full state names. To obtain the full state names 
needed to produce the output messages, the user wouki use a request/ireply message d^inrtion that can send the 
at)brGviations to an application and receive the state names in retu-n. 

[0183] After the user has created a trar^former d^inition 514. the user can test it to make sure it produces the 
30 proper output messages before using it in an integration f k3w. The user can then assign the transformer definition to one 
or more transformers 520. 

[0184] A trar^rmer 520 implements a transformer definition 514. When the user creates a transformer 520. the 
user specify objects 510. 530 to use as sources of the primary Input message and the objects 510. 530 tfiat are to be 
targets for the output messages. The user also specifies the objects that are to reply to requests for supporting irputs. 

35 ^JAftien the transformer 520 receives a primary input message from a source object 540. it runs the sequence of steps 
defined in the transformer definition 514 ttiat make up the transformation process. It then reads the primary and sup- 
porting input messages, transforms the input data, writes the transformed data to one or more output messages, and 
sends the output messages to the target objects 540. A typk^al transfonnation process is shown in Rg. 9. The trans- 
former 520 receives a primary input message 920 from a hub 51 8. It then obtains a supporting input message 940 from 

40 a reply adapter 226. Finally, the transformer 520 sends two different output messages 960. 980 to two different target 
adapters 224. 

[0185] Hubs 518 are message hokfing areas for adapters 220 and transformers 520. Hubs 518 alfow adapters 220 
and transformers 520 to exchange messages asynchronously, and simplify links among objects. For example, the user 
may have a source adapter 222 that produces messages to a transfonmer 520. The user may want the adiapter 222 to 
45 produce and send its messages regardless of whether the transfomner 520 is ready to receive them. The user couM set 
up the adapter 222 to send its messages to a message hub 51 8. and set up the transformer 520 to receive the adapter's 
messages from that hub 518. The system 100 then delivers messages from the hub 518 to a target object 540 when 
the target is ready to receive them. 

[0186] Furthermore, the us^ may have three source adapters 222 sending messages based on the same mes- 
so sage definition 512 to five targets 224. 520. If the i^er dkj not use a hub 518 (as shown in Rg. 10(a)), the user wouti 
have to aeate a total of 15 links among those objects. On the other hand, if the user uses a hub 518 as shown in Rg. 
10(b)). the user wouki have to create and maintain only eight links. Message hubs 518 can hold one kind of message 
only {Le., messages produced from a single message definition 512). Targets of hubs 518 have durable subscriptions. 
The system 100 keeps frack of the messages each target object 224. 520 has received from the hub 518. as well as 
55 those that the target objects 224, 520 have not vet received. If a target object 224. 520 becomes inactive, the system 
100 remerTt>ers the last message that the target object 224. 520 has received. When that target object 224. 520 next 
becomes active, the system 100 delivers only those messages that the target object 224. 520 had not yet received. If 
hub subscriptions were not otherwise durable, target objects 224. 520 wouM receive messages that arrived at hubs 518 
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whfle the target objects 224, 520 were active, txit would never receives messages that arrived at the htte 51 8 when the 
target objects 224. 520 were not activa 

[0187] The user can choose from two messaging styles the user wants the system 1 00 to use when delivering mes- 
sages from the hub 518: (1) point-to-point, where the system 100 delivers each message to the first available target 
5 only: or (2) put)lish/subscr3)e, where the system 1 00 delivers each message to et^ery object the user has identified as 
a target of the hub 518. 

[0188] If the user wants to saeen a certain kind of data out of pan of an integration flow 540, the i^er must use a 
filter definition 516. Filter definitions 516 specify criteria based on message data {Le„ data that passes the criteria con- 
tinues through the flow), while data that does not pass the criteria is discarded. 
10 [01 89] When the user wants to filter a certain kirKi of message, the user aeates a filter definition 516 and assigns 
it to one or more Bnks between objects 540 tfiat handle that kind of message. The system 1 00 applies the criteria in the 
filter definition 51 6 to all messages sent along tftose links. 

[01 90] For exannple. consider the situation in which a hub 520 sends messages containing data on new customs 
to a target adapter 224. The user may want only data on customers who have not yet paid to reach the target adapter 
15 224. In order to do so, the user would aeate a titer definition 516, which specifies ihe criterion "Status = Paid", and 
assigns it to the link between the hub 518 and the target adapter 224. 

[01 91 ] The user can create one or nx>re fitter definitions 51 6 for e^ message definition 51 2 in the user's integra- 
tion f kwv 540. The user can assign a single fitter definition 51 6 to multiple links, or the user can assign different f 3ter def- 
lnitk>r^ 51 6 fa the same kind of message to different links. 

^ [01 92] For example, consider the situation in whrch a hub 518 sends messages containing data on new customers 
to two adapters 220. The user may want one adapter 220 to receive only data on customers who have paid, and the 
other adapter 220 to recdve only data on customers who have not yet paid. The user wouU, thus, aeate two f iter def- 
initbns 51 6. One specifies the aiterion "Status = Unpaid", and the other specifies the criterion "Status - Paid". The user 
then would assign each filter definition 516 to the appropriate link. 

25 [01 93] When the user aeates a filter def initk>n 51 6 for messages that do not contain tables of data, the aiteria the 
user specify affects the entire message. The entire message either passes the fOter criteria and continues through the 
flow, or it does not pass and is discarded. 

[0194] When the user aeates a filter definition 516 for n^essages tfiat contain tables of data, the user can specify 
criteria that affect the entire message or that affect only the data within a table. If the user specifies aiteria for message 

30 items in a section 620, the entire message either passes the criteria and continues through the flow, or it does not pass 
and is discarded. If the user specifies criteria fa message items in a table 640, the message continues through the flew 
with only those rows of data that pass the aiteria. Rows tfmt do not p^ the aiteria are dscarded. 
[01 95] For exarrple, consider the situation in which a message contains a table 640 with nine rows of data, one for 
each of nine new customers. If the user set up a filter definition 51 6 that f Oters out aimers who spent $ 1 000 or less, 

35 rows containing data on customers who spent more than $1000 would continue through the fkMf, while rows containing 
data on customers who spent $1000 or less would be discarded. 

[0196] After the user has aeated a filter definition 516, the user can test it to make sure it works property before 
using it in an integration flow 540. 

[0197] Once the system objects the user wants to use in an integratkxi flow 540 exist the user can indicate hew 
40 the user wants the system 1 00 to route messages among them. To do so, the user sets up links among the integration 
objects 530. Each link estat)lishes one object as a source and the other as a target, a one object as a requester and 
the other as a replier. Source adapters are always message sources. They can send messages to target adapters of 
the same agent servk;e type (e.g., an SAP R/3 source adapter can send messages to an SAP R/3 target adapter), to 
message hut>s 518. and to transformers 520. 
45 [0198] Transformers 520 can be targets, requestors, and sources. They can receive primary input messages 920 
from source adapters 222, message huk)s 518. and other transformers 520. They also can request supporting input 
messages 940 from reply adapters 226 and message hut>s 518, and send output messages 960, 980 to target adapts 
224. hubs 518. and other transformers 520. Message hubs 518 can be targ^ and sources. Target adapters 224 are 
always targets. They can receive messages from source adapters 222 of the same agent servk;e type, from hut>s 51 8, 
50 and from transformers 520. 

[01 99] By default, the system 1 00 uses "message persistence". That is. it writes each message it delivers from one 
integration object 530 to another to stat>le storage in a location the user specifies. If a system failure occurs while a mes- 
sage is in transit, the system 100 can retrieve the message from ^rage when the system is restaed and deliver the 
message to its targets. 

55 [0200] Because message persistence inaeases system overhead, the system 1 00 allows the user to tum off per- 
sistence for any integration object 530. However, if a system failure occurs while messages to a from that object are in 
transit those messages might be lost. The system 100 offers other delivery-related options that he^ the user manage 
the user's system resources. The system 100 maintains message hokiing areas for each integration ctiecX in an inte- 
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gration flow. The user can also control the size of these holding areas. 

[0201] The user can limit the numt)er of messages the system 100 holds for each object at one time, and the user 
can limit the length of time the system 1 00 holds each messaga H an integration ot^ject 530 produces messages more 
quickly than its targets can receive them, these limits can prevent the object's holding area from g-owing to a size that 

5 strains system resources. 

[0202] The user designs all intention flows within a project on the workbench 1 20. Those integration flows that the 
user designs and saves {Le., the definitk>n 510 and integration objects 530 that the user aeates, and the links anrKxig 
them) are all stored In the repository 140. The project is a logical structure that lets the user view the repository 140. 
Each installation of the system 100 has one project arvJ one repository 140. 

10 [0203] The general structure and design philosophy of the message object used by all message producers in the 
system 100 will now t>e disck>sed. The message nrxxjel as disclosed herein is infinitely extensible and us^l for con- 
vening to and from native file formats as well as for sending internal messages from node to node in the system 100. 
The message is hierarchical in nature and uses a name/value pair paradigm to represent the data. Data represented 
by the message model according to the present invention is always object based. It an instance of a Java object of a 

IS certain class. Each data node is type-safe in the sense that it may only contain data that is of the specified dass. The 
structure of a message is metadata-driven. 

[0204] That is. well-constructed ntessages are always built using the scheme laid out in an object known as the 
message definition 51 2. Every message of a certain "type" is built from the same message definition 512. The message 
definition 51 2 ^ itself an instance of a message, although its nodes have been extended to contain information on how 
20 to buiM instartces of the format it descries, as well as optional information on how to convert data to and from a native 
application file format 

[0205] As noted bri^ly herein atx]ve, a message 600 is a tree-structured collection of sirrple and compound 
objects. All objects that can appear in a message are various types of "message entries". In a presentiy preferred 
enbodiment of the invention, a message entry comprises one of following types: (1) a data element (2) an array ele- 
25 ment: (3) a table element arxJ (4) a section element or "message link". The message always has a single section ele- 
ment at the top of the tree, known as the lop level section". This and other sectior^ may contain instances of any of the 
four element types. 

[0208] A data element contains "atomic" data, although the data is wrapped in a Java dass. For example, integer 
data is stored in a java.lang.lnteger object, data/time information is encapsulated in a java.util.Calendar object, and so 

30 forth. An array element is a collection of one or nrx>re primitive elements. An array's length is specified in tiie metadata, 
although this length may be specified as an altowaUe range, in which case the length is determined by parsing a native 
applk^ation's file record. A table element is actually an isonrnrphic collection of section elements, which means that 
each "row" of the table is a section containing exactly the same combination of names and types. It also has a poten- 
tially variable range specification. A message link is a pointer to another persistent message definition in the system 

35 and is used to merge formats. This is useful for implementing "redefines". The message can represent optk>nal data« 
as well as default values, as dctated by the message definition. 

[0207] In its simplest usage, one creates an empty generic message is aeated by invoking a static factory method 
in the message def inition dass. This aeates a message with all ttie proper nameA^ue pairs, but each data item is set 
to null. The only publk;ly exported message constructor requires a message definition as a parameter, ensuring proper 
40 form. The message API provides a way to access its elements, either via named lookuf) or through section iterators. It 
should be noted at this juncture that the message supports a hierarcN'cal nanv'ng schenrte i^ng a configurable separa- 
tor, allowing full or relative "pattiname" access to any component in the hierarchy. 

[0208] A section 620 is a non-repeating group of message elements. Such section elements do not themselves 
contain actual data. Instead, they contain other message elements tfiat contain data (/.e., they contain items 660). Sec- 
45 tions 620 can contain any corTt>ination of message element types. 

[0209] A table 640 is a group of section elements, called rows that can repeat any number of times. Table elements 
also do not contain actual data. They contain other message dements that contain data [i.e., they contain items). 
Tables 640 can contain any combination of message element types. 

[021 0] An item 660 is a message element that contains data. Items 660 are the lowest level message elements in 

so the hierarchy of the message definition. They cannot contain other message elements. 

[0211] The user designs all integration ftaws 540 within a project on the workfc>ench 120. Those integration flows 
540 that the user designs and saves (/.e., the definition 610 and integration objects 620 that the i^er creates, and the 
links anrK>ng them) are all stored in the repositoryl 40. The project is a bgical structure that jets the user view the repos- 
itory 140. Each installation of the system 100 has one project and one repository 140. 

55 [021 2] In accordance with another inrportant aspect of the present invention, system 1 00 comprises a distrSxited 
system. That is, the user can run the system components that make up the system 100 on one or wore physical 
machines (Le., hosts), but all of the components working together as one application. 

[0213] A node is a physical process that runs on a host and supports one or nK>re services. Each node is a Java 
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virtual machine (JVM) and is recognized by the operating system as a javaw. exe process. The user must aeate at least 
one node for each host that runs an enterpr^ applicat'on the i^er want to integrate. The us& can have as many nodes 
as the user's business requirements dictata 

[0214] There are two primary interfaces within the system 100: (1) the workbench 120; and (2) the adntinistration 
5 console 160. The workt>ench 120 provides tools for creating and modifying integration flows 540. whfle the administra- 
tion console 160 provides ail of tools for managing the system nodes and services. Both are described in greater detail 
herein below. 

[021 5] Creating an integration flow 540 in accordance with the present invention may be done as follcws. The user 
first must obtain agent services from the system 100. On the administration console 160. the user then configures the 
10 system nodes of each host machine on which an application the user wants to integrate is running. Then, the user con- 
figures the required services on the nodes, including an agent service for each application that the user is going to inte- 
grate. 

[0216] In order to plan an integration flow, the user should determine the following factors. For example, the user 
must determine the kinds of data the i^er need to extract from applrcations and propagate to applications. The user 
15 should also consider: (1) how the user wants to route messages among the system objects; (2) how the user neecte to 
transform the data from one application so it can be used by other applications; and (3) whether the user needs to filter 
certain data out of the flow. 

[0217] On the worl4>ench 120, the user shouM first create a project, and then create an integration flow in the fol- 
lowing manner. Rrst, the user should configure adapters 220 to interact with the user's applications and create the mes- 
20 sage ddinitions 512 the user needs to produce the proper messages in the integration flow 540. These message 
definitions 512 shoukJ then be tested to make sure they produce the proper messages. 

[0218] Next, the user shouki create hut>s 51 8 to hoM messages from adapters 220 arxJ transformers 51 8. The user 
may then create mapping definitions 514 to transform messages from the source application 541 to messages for the 
target application 549. Furthermore, the user may aeate sample input messages 920, 940 and use them to test each 

25 mapping definition 514 to make sure it produces the proper output messages 960, 980. 

[021 9] Then, the user should create the transforn^rs 520 necessary to implement those mapping definitions 51 4. 
As needed, ttie adapters 220, transformers 520, and hut>s 626 should be linked. If the user needs to filter certain data 
out of the flew 540, the user shouki then aeate fitter definitbns 516. Preferat>ly using sample messages, the i^er 
shouU next test the fitter definitions 51 6 to make sure they filter out and proper data Then, the user may assign the filter 

30 definitions 51 6 to links between objects. 

[0220] On the workt>ench 120. the us^ shoukJ then check the validity of the integration flow 540 and conect it as 
necessary. The user may then save and dose tiie project. On the adrrtinistration console 1 60, the user shoukj then con- 
figure the log viewer so the user can view messages on system activity. If ttie user wants to view statistics on system 
activity (e.g., number of messages produced in specif ic time intervals by indivkiual transformers), the user shouki then 

35 configure the statfetics viewer. 

[0221 ] A^in, on the admin^tration console 1 60. the user may start the integration f fow by starting the relevant sys- 
tem nodes and servk^es, including the agent servrces for the applk^ations the user is going to integrate. Next, the user 
will check the log and statistics to make sure tiie integration flow 540 is running properly. If the user needs to make 
changes to the integratfon flow 540, the user shouki accordingly stop the relevant services on the administration con- 

40 sole 1 60, modify the integration flow 540 on the workbench 1 20. and restart services on the administration console 1 60. 
[0222] The following describes to one of ordinary skill in the art the procedures that may t>e used witti a source 
adapter wizard, a target adapter wizard, and a reply adapter wizard, all in accordance witti ttie present invention, to 
properly configure an adapter 220. In general, ttiere are four separate processes. 

[0223] Rrst. one must carry out the folfowing general steps: (1) name the adapter 200; (2) choose ttie agent servfoe 
45 one desires to host the adapter 220; and (3) choose the message definition 512 for messages that the adapter 220 Is 
to produce, receive, or reply to. Second, one must carry out the following general steps: (1) choose a particular adapter 
220 ttiat is to be configured (I.e.. standard or custom); (2) provide connection Information: and (3) provkle irrplementa- 
tion information. More often tiian not, ttie step of providng implementation information includes the step of extracting 
the message definition 512 of that adapter 220. 
50 [0224] The third process depends on ttie type of adapter 220 to be created. If one is aeating a source adapter 222, 
one must specify the targets to which ttie adapter 222 is to be used to send messages. On the other hand, if one is are 
creating a target adapter 224, one must specify the sources from which the adapter 224 is to be used to receive mes- 
sages. If one is creating a reply adapter 226. furthernrK}re, one must specify the requesters (i.e., transformers 520) to 
whk;h the adapter 226 ^ to be used to send reply messages. 
55 [0225] One must finally specify delivery options (e.g., message lifetime) for ttie adapter's messages. However, 
before one can aeate an adapter 220, ttie agent service that is to host the adapter must exist on the administration con- 
sole 1 60. For example, before one can aeate an EntireX Broker adapter, ttie agent service for the EntireX Broker must 
exist. If one wants to also specify source, target or requester objects for an adapter 220 using the adapter wizard, those 
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objects must exi^ before one opens the adapter wizard. 

[0226] Referring again to Rgs. 4(a) and 4(b). agent-adapters 200 interface with the application resources on one 
side and the infrastructure of system 100 on the other. On the one hand, the adapter half of each agent-adapter 200 
uses the API of its particular application resource, or any other published interface mechanism. On the other hand, the 
5 agent side conforms to the event and messaging nxxiel of system 100 as deserved in greater deiail herein below. In 
combination, the agent and adapter mediate the cfifferences in interface protocols aixj data structures, providing a uni- 
fam, normalized view of the txjsiness events that they \}M\sh and consume. 

[0227] Unlike other application integration solutions, the extensa)le design of the adapter architecture provides — 
the at}ility to seamlessly acconvnodate change to application irrterfaces. while stiD supporting the cunent set of basic 

10 interfaces. This is particularly important with systems that are already in production. For instance, a packaged applica- 
tion having a basic set of interfaces A' which are supported by a particular version of agent-adapter 200. If a newer ver- 
sion of the application incorporates a newer set of interfaces A", the user may choose to simultaneously adapt to the 
older interfaces A' for the proc^ction environment while adapting to A** for a pre-production environment in order to test 
the new interfaces. With this facility, irrcremental change into the integration environment can be negotiated seamlessly. 

15 [0228] Every conponent of system 1 00 ^ distrftxitat)le across all supported platforms, agent-adapters 200 flexSily 
extend this to the participating applications. Key components of system 100 (e.g.. agent-adapters 200 or integration 
sender 26) can, thus, be co-located with applications, or accessed remotely, or both. Numerous depbyment configura- 
tions are possible — the environment is optimized to t)alance availability, performance and administration requirements. 
[0229] Many standard adapters 200 are supplied with system 100. inducting SAP. MQSeries. EhJTIRE Broker, 

20 RDBMS & GIGS. As such, the adapters 200 support rapid depk>yment arxJ easy integration of these information 
resources. They also reduce training and skills required. The ADK 130. inducting all of its automation wizards tem- 
plates, provides hdgh productivity. It is adaptable to any user's IDEs, and it fadlitates o^tomizing supplied adapters and 
develcping cu^m interfaces. The adapters 200 are made up of popular language arKi interface bindings, induding 
Gm-, %lava, EJB, CORBA. COM. and tslatural. In such a manner, th^ plug into any user's environment and tools. They 

25 leverage in-house language expertise, and they are adaptable to complex resource interface requirements. The agent- 
adapter architecture according to the present invention, thus, provides a robust fadlity supporting far more than sinrplis- 
tic interfaces. It ensures a uniform event across the resource portfolio. 

[0230] The agent-adapter subsystem ccxnprtees the runtime interface nxxlules that connect external applications 
to the EAI. On the adapter side, it is the physk^al interface to the external application. The agent side acts as a host for 

30 the adapter, manages resources and publishes events on t>ehatf of the aciapter. 

[0231 ] The base adapter dasses wittiin system 1 00 are as follows. The "Adapter Main" dass provides the ability for 
the adapter to start itself and process its configuration definitions. H is also responsible for instantiating instances of the 
classes to be used by the four possible types of adapter communications. The "Adapter Receiver" dass provkJes the 
ability for the adapter to receive a document from EAI and pass it on to the third party package. The "Adapter Sender" 

35 dass provkies the atMlity for the adapter to recwe a document from a third party package and pass it on to EAI. The 
"Adapter Responder" dass provkies the ability for the adapter to receive a document from EAI, pass it on to a third party 
package, receive a response from the third party package and return the response to the EAI for prcx;essing. The 
"Adapter Requestor" dass provkies the ability for the Adapter to receive a document from a third party package, pass 
it on to EAI for processing, receive a response from EAI and retum the response to the third party package. 

40 [0232] The EAI agent-adapter interface acccxding to the present inventk>n is realized by the aciapter implemerrting 
several Java interfaces, while the adapter to agent interface is realized by the adapter using known methcxJs of the 
ncxie/agent components. 

[0233] According to still another important aspect of the present inv^rtron, every adapter mu^ implement the fol- 
lowing interface. For the AdapterBridge. the method: 

45 

initialize(Agent-adapterConfig) 

is invoked by the agent during initialization and used by the adapter to bcxststrap itself. The adapter brdge is within the 
methcxJ that the adapter 220, 220*, 220" must query the agent 210 to determine what document definitions are to be 
50 processed arxi the type of processing provkied for each dcx^imient. This acconrplished using the following agent 
methcxJs: 

GetsendDcicumentDeflnltifmsO 
getReceiveDocumentDefinitionsO 
55 getRequestDocumentDeflnttionsO 
getResponseDocumentDefinitionsO 

This method will then parse the AdapterConfiguration document to locate the subsection pertaining to the specific doc- 
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ument definitioa hartxx the document specific configuration Infonnation and create an Instance of a specific dass 
based on processing type (send, receive, request or response). It wfll sut>sequentty either start a Thread(Send or 
Request types), issue the Agent.setReceivelJstenerO(Receive type) or issue the AgentsetResponseUs- 
tenerO(Response type) to register the agent callbacks to t>e invoked when a message arrives. 
5 [0234] The restart ( ) method is invoked by the agent 220, 220\ 220" to cause the adapter 21 0 to terminate all activ- 
ity, reload configuration data and restart itself. The shutdown 0 method ts invoked t>y the agent 220, 220', 220** during 
termination processing. 

[0235] The folbwing interfaces are also implemented by the adapters 220 as desabed herein t>elow. For the 
Receivelistener interface, an 

10 

onReceiveMessage(RecelveData) 

method is invoked by the agent 210 on receipt of a JMS message, and he agent will pass the document on to the 
adapter for processing. This processing will occur inder control of the JMS session thread. The adapter processing will 
15 basically consist of a one way routing of the document to the third party software application using the interlaces pro- 
vided by the application. It shouU be noted, however, that there is no reply expected from the applk:ation on this type 
of call. The adapter 220, 220', 220" will t>e expecting only a success or failure response from the application. If EAI is 
expecting an actual resporrse from the third party system, the ResponseListener interface shouU be used instead. 
[0236] For the SmjListener interface, an 

20 

onsendTimerEvent(SendData) 

method is invoked by the agent 210 rf the adapter 220, 220*, 220" is utilizing the timer feature of the node/agent This 
feature is useful when the third party interfece has no way to implement an event driven notification for docun^ents to 
25 be sent to EAI for processing. 

[0237] For the RequestListener interface, an 

onRequestTimerEvent(RequestData) 

30 method is invoked by the agent 210 if the adapter 220, 220', 220" is utilizing the timer feature of the node/agent This 
feature is useful when the third party interface has no way to implement an event driven notification for documents to 
be sent to EAI for processing. It should be noted at this juncture, however, that the RequestL^ener interface differs 
from the SendUstener interface, in that it will send the document to EAI and wait for a document in response. lYas 
response will then be passed back to the third party system. 

35^, [0238] For the ResponseListener interface, an 

onResponseMessage(ResponseData) 

method is invoked by the agent 210 on receipt of a JMS message, and the agent 210 will pass the document on to the 
40 adapter 220. 220', 220" for processing. This processing will occur under control of the JMS session thread. The adapter 
processing will consist of routing of the document to the third party software application using the interfaces provided 
by the application and then sending the response back into the System 100 for additional processing. However, if the 
System 100 is not expecting an actual response from the third party system the ReceiveListener interface shoukJ be 
used instead. 

45 [0239] When a user installs system 1 00, the main corrponent the user installs is a node manager 1 21 0 as shown 
in Rg. 12. The node manager 1210 is a Java virtual machine (JVM), which provides services to all of the other nodes 
and servfoes the user installs in the system. System installation automatically creates repository servk;e 1220, i^er 
interface service (UlS) 1230, and vnonltor service 1240 on the machine that hosts the node manager 1210. 
[0240] Before the user can start a client 1205 (e.g., the administration console 160 or the integration workt>ench 

50 120) session, the user must start the node manager 1210. As noted above, node manager 1210 automatically starts 
the repository service 1230 and the UlS 1240. Otherwise, the user cannot use the administration console 160 a the 
integration worM>ench 120 unless ttiose services are running. Depending on the particular administration console 160 
or integration workt>ench 1 20 task the user is performing, other services may be reqiired. 

[0241 ] Once the node manager 1 21 0 is running, the i^er must corrf igure the system nodes and services, including 
55 agent services 1 250 for the applications the user wants to integrate. The user initiates this by first using an administra- 
tion console 160 session. The user can then start an integration workbench 120 session and begin designing integra- 
tion flows 540 as shown in Rg. 5(c). When the user is finished designing such integration fksws 540, the user may 
thereafter start them by starting nodes and services from an administration console 160 session. 
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[0242] When the user starts a cOent session, the user identifies the node manager 1 210 as the dienfs server 1215. 
The user may connect as many integration worM>ench 120 and administration console 160 sessions to the node man- 
ager 1250 as the user's business requirements dictate. All such integration workt>ench 120 and admintetration console 
1 60 sessions will k>e read-only. Console sessions connected to the node manager 1 250 have access to the contents of 
5 the repository service 520 that s running on that node manager 1210. When working with system 100, the i^er must 
run the node manage 1210, an administration console 160 session, and a integration \M)rkt>ench 120 session. 

Nodes 

10 [0243] As noted herein atx>ve, arx^ referring now ateo to Rgs. 13(a) through 13(c) in conjunction with Frg. 12, a 
node 1310 is a physical process that runs on a host 1300 and supports one or nrv>re services. Each 
virtual nnachine (JVM), and is recognized by the operating system as a javaw.exe process. The user must create at least 
one node 1310 for each host 1300 tfiat runs an enterprise application that the user wants to integrate. The user can 
have as many nodes 1 31 0 as the user's business requirements dictate. 

15 [0244] A service is an object tttat provides product functionality. System 1 00 generally comprises system services 
and application services. A client graphical user interface (GUI), such as the integration wortdbench 120 and adminte- 
tration console 160, enables the user to work with system 100. Clients 1205 (Fig. 12) may run on the same physk^al 
host 1300 on which nodes 1310 and services are running, or it can run on a different host 1200. 
[0245] Each enterprise must also have a node manager 1210. The node manager 1210 provides services to aD of 

20 the other nodes 1310 in the system 100. It runs the user interface service (UlS) 1230 and the repository service 1220. 
Rg. 13(a) illustrates one environment having three hosts 1300. Hosti is running the Node Manager 1210, white Hosti 
arxi Host2 are txith running nodes 1310. 

[0246] System 1 00^ a collection of systOT services and application &ervk;eaSy^em services support nodes ard 
services. R>r example, the monitor service 1240 stores system runtime data for rxxies 1310 and services. Application 
25 services provide functionality to system 1 00. For example. CICS agent services support adapts that need to connect 
to CICS applications. 

System Services 

30 [0247] System services according to the present invention generally comprise a user int^ce service (UlS) 1230, 
a repository service 1220, and a monitor service 1240. UlS 1230 more spedficaDy provides the facilities necessary to 
run client components (i.e., the integration workbench 120 and the administration console 160). Likewise, the reposi- 
tory service 1220 stores the configurations for all configured services and integration fkTw objects 540. Rnally. monitor 
service 1240 staes system runtime data, including system togs and statistics information. 

35 

A pplication Services 

[0248] Referring again to Fig. 1 2, it can be seen that application services used in system 100 include the enterprise 
messaging service (EMS) 1260, whk;h enables the system 100 to use multiple messaging modes, including point-to- 

40 point, publish/sut>scrbe, and request/reply messaging. EMS 1 260 also supports message hubs and provides message 
persistence. Application services also include an integration service (IS) 1270. which enables the system 100 to trans- 
form messages, including splitting messages, combining messages, and manipulating message data. The IS 1270 
additionally supports transformers. RMl factory services (not shewn) may optionally be used as an application service 
to manage remote method invocation (RMl) links to extemal applications. Routing services 1280 also comprise an 

45 application service, which enables the system 100 to direct messages through the system based on a message's con- 
tent, including filtering message content according to criteria ttie user define, and determining whether messages are 
valid. The routing service 1280 also supports filters. Agent services 1250 support adapters. The user must instaO an 
agent service on each host 600 that runs an enterpr^e application the user want to integrata As shown in Rg. 13(b). 
Hosti and Host2 are both running services. Host3 cannot run servrces because is does not have a node 1310. 

so 

Client? 

[0249] The system 100 includes two cfient GUIs that enable the user to work witii integration flows 540. Clients may 
run on any host 1300. regardless of whether the host 1300 runs the node manager 1210, runs nodes 1310 and serv- 
55 ices, a does not run any nodes 1310 or services. The user can install as many clients as the user's business require- 
ments dictate. For example, a user might want to install clients 1 205 on a network-attached host to work with the user's 
integration flows 540 from a remote location. In Rg. 13(c), botii Host2 and l-tost3 are running the administration console 
160 and integration wortd>ench 120 clients. Hosti, on the other hand, is not running either tiie administration console 
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160 or integration workbench 120 clients. 

[0250] "mere are two primary interlaces within the system 100: (1) the worW>ench 120 and the adminfetralion con- 
sole 160. Ttie workbench 120 provides toote for aeating and modifying integration fbws 700, while the administration 
console 160 provides aD of tools for managing the system nodes and services. Both are descrbed in greater detail 
5 herein below. 

[0251 ] Creating an integration flow 700 in accordance with the preserrt invention may be done as follows. The user 
first must obtain agent services from the system 100. On the administration console 160, the user then configures the 
system nodes of each host machine on which an application the user wants to integrate is running. Then, ttie us^ con- 
figures the required servk;es on the nodes, including an agent service for each application that the user is going to inte- 
10 grata 

[0252] tn order to plan an integration flow, the user shouU determine the fdkswing factors. For exarrple. the i^er 
must determine the kinds of data the user need to extract from applications and propagate to applications. The user 
should ateo consider: (1) how the user wants to route messages among the system ot>jects; (2) how the user need to 
transform the data from one application so it can be used by other applications: and (3) whether the user need to filter 
15 certain data out of the i\OM. 

The Conversion Process Accessors and Converters 

[0253] As noted herein atx>ve, another irrportant function of the message model is to import to and export from 
20 native file formats from any application. RIes containing both character and binary data in applicatfon and platform-spe- 
cific formats are brought into the "canonical" fomn descrfoed. where the data are represented as Java objects. A key 
goal in the design of this scheme is to maximize reusability. Therefore, a given message definition can be custom-con- 
figured with wtiat is conceptually a "devfoe driver. That is. two native f Oe formats, which structurally represent the same 
data format can produce identicalty structured canonical messages when configured with the proper drivers. The 
25 "device driver" is actually a set of Java objects called "accessors" and "converters", which are attached to their appro- 
priate nodes in the message d^inition metadata, arxi global metadata. 

[0254] A fully configured message def initbn that has been persisted via Java object serialization then becomes a 
packaged and ready-to-go native file format parser and formatter for a given native f 3e format conversion process takes 
full advantage of the latest character set erKXXfing and localization facilities provkied k>y tfie Java Development Kit 
30 (JDK). All native character string are viewed as byte anays and are converted internally to Unicode for use by the pars- 
ing and formatting routines. 

[0255] It may be appreciated that Verson 1.1.6 of the JDK supports nearly 100 different character encodings, arxi 
that the message model accorcfing to the present invention handles all of them witti the same logic. The message model 
also strives to use inheritance of item attributes as much as possibia Thus, applfoatfon-spectfic data is assumed to 
35 have a default byte-order, encoding and focala Indivtiual accessors may override any of these, txit in practk;e this 
shouldnl happen too often. 

[0256] The accessors and converters are two-way objects. They can convert native data into a Java object to be 
stored in a message tree and also can transfomn a Java object back to its native representation. In the spirit of reusa- 
bility, one object of the present invention was to minimize the total nurTi>er of conversion classes that need to be written. 
40 Accordingly, the conversion process descrit>ed herein may be viewed as a prot>lem with two axes, tokenization/format- 
ting on one axis and byte conversion on the other. An instance of an accessor class is a Java object that krK>ws how to 
sift through the "syntactic sugar" in a native field and ^ate out the actual bytes that a specific converter needs to pro- 
duce or convert from a Java object. 

[0257] Consider, for exarrple, the case where a floating point data fieM is marked on both skies by a predefined 
45 t>yte or character sequenca These are known as "markers" in system 100. A specific kind of accessor (in this case a 
trailing marker accessor) knows to skip over the leading marker arxi find the location of the trailing marker to isolate the 
four bytes wtich are actually the "meaf of the floating point data. The floating point byte converter prevfousty configured 
in the message definition produces a Java Roat object from the bytes. In the other direction, the accessor writes out the 
leading marker, tells the converter to write out the native bytes, arxJ then tfie accessor terminates with the trailer. One 
50 d^nct advantage of this scheme is that only a handful of accessors and approximately two dozen converters need be 
v^itten. Since the accessors and converters of the present invention are essentially read-only objects once configured, 
the message definition size can be kept relatively small due to object sharing where possEbIa The Java gart>age collec- 
tor convenientiy removes issues of wfK) owns which object in this casa 

[0258] Some accessors and converters need to be configured with initial settings, while others do not These 
55 objects are packaged as JavaBeans, with strrple property dialogs where needed. In accordance with a presentiy pre- 
ferred emtx)diment of the invention, the following table sets forth the accessors supporting the system 100. As new 
types are needed, they can be seamlessly added to system 100 without the need for writing new converters. 
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Accessor Type 

Characteristic 

5 

Fixed length 

Accessor field is always a fixed length. This fixed length indicates either the entire field 
length, or its length minus any markers. 

10 

Incficated length 

Essentially the same as a fixed length accessor, except that another lnteger-compatS)le field 
in the data contains the length specifier. These length indicators are what are known as 
linked" objects, and may optionally be flagged as "transient" objects, the details of both of 
wNch are descrS>ed in greater detail herein belcw. 


Trailing marker 

The f ieki termtrmtes at the trailing marker. 


Implied length 

The field length is implicit in the converter type - mostly used for binary formats. 

15 

Section^elimited 

If the containing section uses a delimiter scheme, the delimiter can signal the end of the 
object. 


Syntax-based object 

The object matches a certain regular expression. 


20 

[0259] It should be noted that each of the accessors deserved above are item accessors. While much simpler, sec- 
tion accessors may likewise be i^ed. Such section accessors have optional mark^, and may also use a delimiter 
scheme. To some extent the inclusion of such a delimiter scheme depends on the successful parsing of its contained 
elemerrts. Delimiters use either a prefix, infix or posifix scheme, and are in fact the same marker elements used to con- 

25 strain f iekte. Table accessors extend section accessors to work with a linked item tfiat lndk;ates a record count 

[0260] The initial number of converters supporting the system 100 is relatively small, but is very complete based on 
an analysis of commercial f3e formats. The converters accorcfing to the present invention comprise two basic types: 
either a character-based convener or a binary converter. All character converters inherit from a convnon base dass that 
provides the notion of justification and padding characters. Such padding characters may be specified as absolute byte 

30 value characters or as Unicode characters, which are mapped to the native encoding. Character converters according 
to the present invention include: 


35 

Character Converter 
Type 

Characteristk; 

40 

Decimal 

Formats and parses according to a "^format mask", derived from that specified in 
java.text.DecimalFbrmat The mask is of the form #,##0.0##, and can specif ly features 
such as leading or trailing minus signs, etc. The mask grammar will be extended as 
needed to enable any pre- or post-processing where tfie grammar is insufficient 


Integer 

Same as decimal converter, but no decimal places are alkswed. 


Currency 

Also supported by Java, a further refinement of decimal converter. 

45 

Date/time 

Uses java.text.SimpleDateFamat mask specification. Thisformat is quite extensive, and 
should satisfy all needs. 


Generic string 

Relies on fixed length, trailing marker or section delirruter for demarcation. 


50 [0261 ] Binary corrverters inherit the default message-specified byte-order, but may be individually overridden via a 
constructor argument Those binary converters according to the present invention include: 


55 
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Binary Converter Type 

Characteristics 

SignedAinstgned 2's 
IEEE 754 float and double (1985 specification) 
Packed decimal 

Complement numt}ers of 8. 1 6. 32 arxi 64 bits as well. Unsigned 
types are promoted to the next larger Java integral type if needed. 
H should be noted that Java includes an art^itrary precision pack- 
age in iava.math for unsigned longs. 

JNI can be used for this, as well as IntegerBits and LongBits con- 
verters provided in the Fk>at arxj Doii)le classes. It should be 
noted that this may only t>e supported on platforms of a native 
float type. 


[0262] Converters may produce or consume more than one Java type. For exarrple. a native float converter can 
reasonably map to a Float, Double, Integer, Long or String, among others. All converters implement a native converter 
interface, which specifies an ''Object load(Class, ...)" and 'Void 8tore(Object ... )' functionality. However, the actual sut>- 

20 dass produced depends on which ottier converter interfaces are implemented by the object These are essentially 
marker interfaces, which do not contribute to any new methods. For example, a DoutileConverter. IntegerConverter, 
StringConverter, and so forth may be used in the system 100 without departing from the true spirit and scope of the 
present inventk}n. A corrfiguration tool, such as a ^aphical user interface (GUI) can, through dass introspection, deter- 
mine an appropriate list of converters to present for use in a particular case. Inside the foad and store methods, the con- 

25 verter examines which of its supported int^ces it irrplements corresponding to a dass the Object is an Instanceof 
or the supplied Class. The generic Object retumed or processed is now actually of a proper subtype. 

M arke rs 

30 [0263] Markers may be thought of as syntactic sugar, useful both as field delimiters and Incfividual item tokens. All 
objects, whether sections or items, may indude a leading marker, trailing marker, or both. In accordance with a pres- 
ently preferred embodiment of the inventbn, there are three basic marker formats. Two formats, known as a fixed pat- 
tern marker and a "strtok^-styte marker, specify either a byte pattern or a Unicode string that is mapped to the native 
charader encoding. Comprising a set of characters of which 0 or more occurrences are found, the"strtok"-style marker 

35 is useful for incficating white space or txnary paddirig. The third format, key-k)ased markers, have a pattern in which the 
key of an objed being processed is sut>stitut6d into a pattem. For example, the marker pair ( X -) and </-X-} would 
become < Customers ) and (/Customers ) , which wouki be useful for parsing XML-style messages, and in general he^ 
aid in locating optional items. 

40 Optional Arguments 

[0264] The parsing and recognition of optional arguments is a difficult process. For example, if the input data spec- 
ified is five optional strings of any length, and three strings are successfully read, it may not be possible to know which 
string is which. Optional items not found will be set to ruill in the message. A set of conditions under which optional iten^ 

AS may be recognized in accordance with the present invention follows. 

[0265] Conskier the case in which a section uses delimiters and a delimiter for an empty field is found. For example, 
a user wouM know that the second element was missing if the input was "Able„Chariey" in an infix scheme. Another 
condition in which optional items may be recognized occur when the f ieUs use the key-t>ased marker for seK identifica- 
tion. In the style of C4-1- d^utt function arguments, yet arrother condition wouM arise if all of the optional arguments 

so come at the end of the list and the section end is deteded, the parse is successful. In general, whenever a user fails to 
parse a f ieki con-edly. and the f iekJ is optional, the user skips to the next f ieU and tries again until the end of the section 
is reached. A section with a trailing marker (or end-of-file) would be required here. At the end of the section, if non- 
optional items have not been assigned a value, the parse fails. This would not guarantee corred results if the format of 
successive items wouki be ambiguous. 

55 [0266] Defaults work differently, as per whether this is a section or an item. Message metadata for an item hoUs a 
default objed. By default, if the objed supports the doneable interlace, the objed is doned from the metadata to the 
message instance. If it does not support the interface, the value is stored as a String in the metadata, along with its 
dass and the Java Refledfon API is used to invoke the object's String-based constructor to supply the message with 
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an object. For sections, the default is a link to another persistently-stored message definition. The top-le^el section of 
the referenced message definition would be grafted into the message metadata and a message of the combined struc- 
ture would bes produced. 

5 Unked and Transient Items 

[0267] In some cases, native data is setf-<iescrft}ing. For example, a tat)le may be preceded by its row count Users 
would not want to include this count in the final canonical message produced, however, because it ts self-andent from 
the length of the Java array representing the tabia In this case, the node may optionally be marked as transient It is 
10 temporarily added to the message and removed once the table has been built and added. In this way, the user may con- 
figure a message definitk>n with two different drivers to produce the same canonical messaga That is. if in one case, 
the table length were determined without a count indicator, it would not produce that integer field in the node. Tables 
should be isomorphic in this case, so the argument should be transient. 

[0268] Continuing on with the atx>ve example, one may note that there is an inherent connection between the count 
75 and the tabIa As a result both will be marked as having a link relationshp. Both will additionally hold onto the relative 
and at)solute pathname of the other object, plus a status indicator in their aocessors as seen t>elow. 

COUNT-PROVIDER 
COUNTUSER 
20 LENGTH-PROVIDER 
LENGTH-USER 
REDEFINE-PROVIDER 
REDEFINE-USER 

2S In the case of redefines, the provkJer ^er prcvkJes a string or integral discriminant. The provider item must appear, in 
the parsing cf rection, before its user in the traversal and conversion. In the formatting direction, the provide' first writ- 
ten with a placeholder and sut>sequently filled in with its proper value. It should be noted that the comt provider must 
use afixed length format for tfie above to work. 

30 Validation Pauses and Relationships 

[0269] The message definition has placehoMers in its metadata items for a list of validation clauses and inter-mes- 
sage relations. In accordance with a pres^itly preferred embodiment of the invention, validation clauses are all run on 
the converted message only after the entire message has been converted. The object design does, however, permit 
35 per-item validation clauses if desired. There is also a placeholder to specify relations between columns of a table in one 
message and columns in another ona This facilitates mapping of values and joins. * 

[0270] The manner is which nressage may be created, without and with converting the raw data, is shewn in Rgs. 
13 and 14. Rg. 13 illustrates one method 1340 without converting the raw data tfiat begins at the application 541. 
[0271] The user aeates an empty message (e,g., "DocDef.createNewlnstancel at 1320. arxi the empty message 
40 is populated with the application's data through the message definition AP1 1330. A message instarice 1340 is, thus, 
created. The message instance 1340 then can then go through another applrcation's message d^inrtion AP1 1350 in 
order to send the message to that applicatkxi 1 360. 

[0272] When the need to convert the raw data arises, the method shown in Rg. 14 is employed. In the t>eginning 
application specific data 1410 is received from an application 1420. An empty message is created at 1430 and popu- 
45 lated with not only such application specif k; data 1410, but also raw conversion information. The application specific 
data 1410. by way of the accessors and converters 1440 is sent to a message instance 1450, which also receives the 
infonnation populated in the empty document at 1430. For example, this may be done by: 

DocDef.createDocumentf=romRle 

50 

The API supports both of the following methods to aeate the message: 

DocDef.aeateDocumentFromRle 
DocDef.aeateDocumentFromBytes 

55 

Then, through other aocessors and converters 1460, the message can be converted into another application's applica- 
tion specific data 1470 and received by that application 1480. 

[0273] Referring now to Rga 15(a) through 15(d). the benefits of the message object according to the present 
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invention will now be described. Rg. 15(a) iDustrates one method 1510 of aeating a nnessage without converting raw 
application data In aocorcfence with the present invention. 

[0274] An enpty message is aeated by the application 1512 as a first step. This is (tone by aeating a message 
definition 512 (e.g., "defy/initialize elsewhere def.createEmptyDocumentfdDcname;;"). The application API 1514 Is 

5 coupled to the message definition AP1 1516, in order to populate the message by use of the message defirvtion API 
1516. The, message defaults may next be applied (e.g., "def.appfyDocumertDefaultValues^rfocnamej'O, and a mes- 
sage instance 1518 is. thus, aeated. The reverse method 1520 is shown In Rg. 15(b) where the message Instance 
1522 is sent through the message definition AP1 1524, which Is coipled to the application AP1 1526, and is used to pop- 
ulate field values. The message Is then sent to the application 1528. 

10 [0275] Creating messages with conversion of application data Is a wore difficult matter. As shown tn Rg. 15(c), a 
method 1530 of converting messages according to tfie present invention from an application 1532 to a message 
instance 1538 begins with the message being sent from the application 1532 through a converter. The message defi- 
nition AP1 1 536 aeates an empty message, populates the empty message with the data from the application 1 532 (/.e., 
either from a file or from bytes), and adds raw conversion infomiation from accessors and converters according to the 

15 present invention. For exanrple: 

Document Definition 6e/i'JfPM Accessors and Converters 
Initialize elsewhere 

def.aeateDocunterrtFromRle(docname,//7ename) 

20 

or, 

def.aeateDocumentFromBytes(doa7ame,6Kte//) 

25 The reverse method 1540 is shown in Rg. 15(d), where a n^essage instance 1542 is sent through the message defini- 
tion AP1 1 544, to populate a file or byte array 1 546 with the data from the message instance 1 532. and then to the appli- 
cation 1548. For example: 

Document Definition defy/Add Accessors and Converters 
30 Initialize elsewhere 

def.storeDocumentToRle(ff/eA7ame) 

or. 

35 .def.storeDocumentToBytes(£yfeO) 

Class diagrams for simitar such processes are shown in Rgs. 16 and 17. 

[0276] In accordance with arKSther important aspect of the present invention, system 100 conrprises a distributed 
system. That is, the user can run the system components that make up the system 100 on one or tncxe physical 
40 machines {i.e., hosts), but all of the components working together as one application. Every component of system 100 
Is (fistributable across all supported platforms. Agent-adapters 200 flexibly extend this to the participating applications. 
Key components of system 100 (e.g., agent-adapters 200 or Integration server 26) can. thus, be co-k>cated with appli- 
cations, a accessed remotely, or both. Numerous deployment configurations are possible — the environment is opti- 
mized to t>alance availability, performance and administration requirements. 

45 

Operators 

[0277] The following table generally desai*bes all of the currently contemplated system operators, which a user can 
use to build expressions for message definitions, transformer definitions, and filter definitions. System 100 supports 
50 these operators. 


Operator 

Description 

&& 
II 

Logical "and" 
Logical "or" 
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(continued) 



DP5«criDtk)n 

j 



nooiyi II 1 Id II 



!= 

LO^CoJ nui equal 

+ 

1 In^rvt nil 

unoij piuo 


unaiy minuo 

* 

MUiupiicaoCAi 

/ 

Division 

< 

Less than 

<= 

Less than or equal to 

> 

Greater than 

>= 

Cheater than or equal to 


FMnctipng 

[0278] The table following on the next page generally describes all of the currently contenrplated system functions. 

25 which a user can use to build expressions for validating or filtering nrtessages and transforming message data. Each 
desaiption includes what the function does, the parameters it requires, and the value it retunr^. 
[0279] When transforming message data, the user typically uses these functions to take message item values from 
input messages and create message item values for output messages. When validating or f Btering messages, the user 
usually uses these functions to create boolean expressions. The parameter values for these functions can either be 

30 message items or constant {i.e., literal) values. 


Data Type 

Literal Examples 

Integer 

1234. 0xFF,077, -1234 

Long 

1234. 1234L.^FF.077L 

Double 

12.34 

String 

"Sagavista" 

Boolean 

true or false 

BigDecimal 

12.34a. where "a" means art>itrBry precision 

Calendar 

#DATE(2000. 2. 13) 


#DATE_TIME(2000, 2, 13, 23. 59) 


#DATE_FORMAT("M/d/yyyy". "2/13/2000") 


50 [0280] The system 100 also provides the functions descrit>ed below, although a user can write the user's own func- 
tions for use with system 100. 
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Function 
addToDate 

bigDecimalTo Boolean 

bigDecimaJToDouble 

bigDecimalToLong 

bigDecimalToString 

booleanToBigDecima] 

booleanToLong 

booleanToString 

calendarToString 

compareDates 

doubleToBigDecima] 
doubleToLong 


Description 

Adds a specified number of days to a Calendar object date 
and returns the resulting Calendar object date 

Converts a BigDecinnal object to a Boolean object 

Converts a BigDecimal object to a Double object 

Converts a BigDecimal object to a Long object 

Converts a BigDecimal object to a String object 

Converts a Boolean object to a BigDecimal object 

Converts a Boolean object to a Long object 

Converts a Boolean object to a String object 

Converts a Calendar object to a String object 

Compares two Calendar object date values and indicates 
whether the first date is less than, equal to, or greater than 
the second date 

Converts a Double object to a BigDecimal object 
Converts a Double object to a Long object 


douhleToStrinj2 
findString 


Converts a Double object to a String object 

Searches for a String object within another String object 
and returns the position of the found String's first character 
within the other String 
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Function 
findWord 

foiindString 

foxindWord 

getDate 

getMonth 

getYear 

getXokenAt 

integerToString 
isAIpha 

isAIphaNumeric 

isNumeric 

justifyCenter 

justjfyLeft 

justifyRight 

longToBigDecimal 

longToBoolean 

longToDouUe 

longToSthng 

lookup 

lowercase 


Description 

Searches for a word within a Siring object and returns the 
position of the word's first character within the String 

Searches for a String object within another String object 
and returns a Boolean object 

Searches for a word within a String object and returns a 
Boolean object 

Finds the date in a Calendar object and returns the month as 
an Integer object 

Finds the month in a Calendar objea and returns the month 
as an Integer object 

Finds the year in a Calendar object and returns the year as 
an Integer object 

Parses a String object into tokens, finds a particular token, 
and returns the token as a String object 

Converts an Integer object to a String object 

Ektermines whether all characters in a String object are 
alphabetic and returns a Boolean object 

Determines \^ether all characters in a String object are 
alphanumeric and returns a Boolean object 

I>etermines whether all characters in a String object are 
numeric and returns a Boolean object 

Creates a String object of a specified length and centers 
another String object within it 

Creates a String object of a specified length and left 
justifies another String object within it 

Creates a String object of a specified length and right 
justifies another String object within it 

Converts a Long object to a BigDecimal object 

Converts a Long object to a Boolean object 

Converts a Long object to a Double object 

Converts a Long object to a String object 

Looks up a String object in a lookup table specified in 
another String object and returns the corresponding value 

Converts all characters in a String object to lowercase 
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Function 
replaceSiring 

replaceWord 
sizeOf 

stringToBigDecimal 

stringToBooIean 

stringToCalendar 

stringToDouble 

stringToInteger 

stringToLong 

Subarray 

substring 

trim 

iippeTY:ase 


Description 

Searches a Siring object for a particular Siring object- 
replaces the found String object with a replacement String 
object, and returns the String object with the replacement 
String in place 

Searches a String object for a particular word, replaces the 
found word with a replacement word, and returns the Siring 
object with the replacement word in place 

Determines the size of a String object or a ByteArray object 
and returns the size as a Long object 

Converts a String object to a BigDecimal object 

Converts a String object to a Boolean object 

Converts a String object to a Calendar object 

Converts a String object to a Double object 

Converts a String object to an Integer object 

Converts a String object to a Long object 

Finds a ByteArray object within another ByteArray object 
and returns the found ByteArray object 

Finds a String object within another String object and 
returns the found String object 

Removes \^ite space from before and after a String 

Converts all characters in a String object to uppercase 


[0281] This function adds a Long object that specifies a certain number of days to a Calendar object date and 
returns the resulting Calendar object date. 

Calendar adcfroDate(Calendar,Long) 

[0282] 


Parameter Type 

Value 

(Calendar.Long) 

Date, number of days to add to the date 

RetumType 

Value 

Calendar 

Resulting date 
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Example: 

[0283] A message item named DatePurchased is defined as a Calendar object For another message, the user 
need the value of DatePurchased plus five days in a Calendar object The user would enter the function as foOows: 

5 

addToDate (MsgDef.DatePurchased, 5) 

If the value of DatePurchased were equivalent to February 1 3, 2000, the function would return a Calendar object whose 
value is equivalent to February 18. 2000. 

10 

bi gPedmalTo Boolean 

[0284] This function converts a BigDedmal object to a Boolean object 
15 Boolean bigDecinialToBoolean(BigDecimaO 
[0285] 


Parameter Type 

Value 

(BigDedmal) 

BigDedmal to convert 

RetumType 

Value 

When 

Boolean 

True 

BigDedmal any value other than 0 


False 

BigDedmal is 0 


30 biaDedmalToDout)le 

[0286] This function converts a BigDedmal object to a Double object. 

Double bigDednfialToDouk>le(BlgDecimal) 

[02871 


Parameter Type 

Value 

(BigDedmal) 

BigDedmal to convert 

RetumType 

Value 

Double 

Resulting DoMe 


bioDedmalToLong 

[0288] This function converts a BigDedmal object to a Long object 

50 
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Long bigDeclmalToLong(BigDeclTOl) 
[0289] 


Parameter Type 

Value 

(BigDedmal) 

BigDedmal to convert 

R^mType 

Value 

Long 

Resulting Long 


bipDedmalToString 

[0290] This function converts a BigDedmal object to a String object 

String blgDeclniarroString(BlgDeclmal) 

[0291] 


Parameter Type 

Value 

(BigDedmal) 

BigDedmal to convert 

R^rn Type 

Value 

String 

Resulting String 


booleanToBioDedmal 

[0292] This function converts a Bodean object to a BigDedmal object. 

BigDedmal booleanToBig Decimal (Boolean) 

[0293] 


Parameter Type 

Value 

(Bodean) 

Boolean to convert 

RetumType 

Value 

When 

BigDedmal 

1 

Bodean is true 


0 

Bodean is false 


tx)oleanToLong 

[0294] This function converts a Bodean objed to a Long ot>iecL 
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Parameter Type 

Value 

(Boolean) 

Boolean to convert 

Return Type 

N^ue 

When 

Long 

1L 

Boolean is true 


OL 

Boolean is false 


booleanToStrinq 

[0296] This function converts a Boolean object to a String object 

String booleanToStrlng(Boolean) 

[0297] 


Parameter Type 

Value 

(Boolean) 

Boolean to convert 

Return Type 

Value 

String 

Resulting String 


calendarToString 

[0298] There are two.versions of thte function. 

[0299] The following function converts a Calerviar object to a String object 

String calendaniDStrf ng(Calendar) 

[0300] 


Parameter Type 

Value 

(Calendar) 

Calendar to convert 

Return Type 

Value 

String 

Resulting String 


[0301 ] The follcwing function converts a Calendar otsject to a String object using a format mask to format the String 
object 
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String calendarToStr1ng(Calendar,St]1ng) 
[0302] 

5 


Parameter Type 

\^e 

(Calendar.String) 

Calerxjar to convert format mask 

Return Type 

\^e 

String 

Resuftmg String, in the format specified by the mask 


Example: 

15 

[0303] A message item named DatePurchased is defined as a Calendar object For another message, the user 
need the value of DatePurchased in a String object in the format M/dAyyyy. The user would enter the function as fbllcws: 

calendarToString (MsgD^.DatePurchased, "MAd/yyyy") 

20 

K the value of DatePurchased were equivalent to February 13. 2000, the function would return a String object whose 
value is "2/13/2000". 

compareDates 

25 

[0304] This function compares two Calendar object date values and indicates whether the first date Is less than, 
equal ta or greater than the second date. 

Long compareDates(Calendar,Calendar) 

30 

[0305] 


Parameter Type 

Value 

(Calendar.Calendar) 

Rrst date to compare, second date to compare 

Return Type 

Value 

When 

Long 


-1 

Rrst date sle! 

ss than second date 



0 

Rrst date s equal to second date 



1 

Rrst date is gr 

eater than secorxi date 


45 dPMWgToBiqDgpimal 

[0306] This function converts a Double object to a BigDecimal object. 

50 
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BigDedmal doubleToBigDecimal(Double) 
[0307] 

5 


Parameter Type 

Value 

(Double) 

Double to convert 

Return Type 

Value 

BigDedmal 

Resulting BigDedmal 


doubleToLonq 

15 

[0308] This function converts a Dout)le object to a Long object. 
Long doubleToLong(Double) 
20 [0309] 


Parameter Type 

V^ue 

(Double) 

Dout)le to convert 

RetumType 

Value 

Long 

Resulting Long 


30 

^MWgTQgtrinq 

[031 0] There are two versions of th^ function. 

[031 1] The following function converts a Double object to a String object 

35 

String doubleToString(Double) 
[0312] 

40 


Paran^erType 

Value 

(Double) 

Double to convert 

RetumType 

Value 

String 

Resulting String 


[031 3] The following function converts a Double object to a String object using a format mask to format the String 
50 object 
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String doubleToString(Double,Strlng) 
[0314] 

5 


Parameter Type 

N^ue 

(Double.String) 

Dout)le to convert, fbmnat mask 

Return Type 

Value 

String 

Resisting String, in the format specified by the mask 


Example: 

IS 

[0315] A message item named Discount is defined as a Double object For another message, the user need the 
value of Discount in a String object in the format #.##. Ihe user would enter the function as follows: 

doubleToString (MsgDef.Discount '#.##1 

20 

If the value of Discount were 0.04531 , the function would retum a String otsject whose value Is "0.05". 
findString 

25 [0316] This function searches for a String object within another String object If the function finds the specified 
String object, it returns the position of the String's f orst character within the other String. 

Long findString(String,String) 

30 [0317] 


Parameter Type 

Wlue 

(String.String) 

String to search, String to find 

Retum Type 

V^ue 

When 

Long 

Position of the String's first character within the other String 
-1 

String is found 
String is not found 


findWord 

45 [0318] This function searches for a word wittiin a String object. If the function finds the specified word, it returns the 
position of the word's first character within the String. The function can only find the word when it is bounded by white 
space witftin the String. 


so 
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Long ftndWordCSti1ng,Stf1ng) 
[0319] 


Parameter Type 


(String.Slring) 

String to search, word to find 

Return Type 


When 

Long 

Position of tfie Word's first character within the String 
-1 

Word is found 
Word is not found 


foundStrinp 

[0320] This function searches for a String object within another String object and returns a Boolean object. 
20 Boolean fbundStr1ng(Strlng,String) 
[0321] 


Parameter Type 

Value 

(String^String) 

String to search, String to find 

Return Type 

Value 

When 

Boolean 

True 

String is fourxi 


False 

String is not found 


, , 35 found Word 

[0322] This function searches for a word within a String object and returns a Boolean object The function can only 
find the word if it is tx)unded by wtvte space within the String. 

40 Boolean found Word(String,Strlng) 

[0323] 


Parameter Type 

Value 

(String.String) 

String to search, word to find 

Return Type 

Value 

When 

Boolean 

True 

Word is fourxl 


False 

Word is not found 


55 qetOate 

[0324] This function finds the date in a Calendar object and returns the date as an Integer object. 
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Integer getDate(Calendar) 
[0325] 

5 


Parameter Type 

Value 

(Calendar) 

Calendar to read 

Return Type 

Value 

Integer 

Resulting Integer, from 1 through 31 


Example: 

15 

[0326] A message rtem named DatePurchased is defined as a Calendar object For another message, the user 
need the date from the value of DatePurchased in an Integer object. The user would enter the function as follcws: 

GetDate (MsgDef.DatePurchased) 

20 

If the value of DatePurchased were equivalent to February 13. 2000. the function would return an Integer object whose 
value is 13. 

getMonth 

25 

[0327] This function f incte the month in a Calendar object and returns the month as an Integer object. 
Integer getMonth(Calendar) 
30 [0328] 


Parameter Type 

Value 

(Calendar) 

Calendar to read 

RetumType 

Value 

Integer 

Resulting Integer, from 1 through 12 


40 

Example: 

[03^] A message item named DatePurchased ^ defined as a Calendar object For another message, the user 
need the month from the value of DatePurchased in an Integer object. The user would enter the function as follows: 

45 

getMonth (MsgDef.DatePurchased) 

If the value of DatePurchased were equivalent to February 13. 2000, the function would retum an Intieger object whose 
value is 2. 

50 

qetTokgnAt 

[0330] There are two versions of this function. 

[0331 ] The following function parses a String object into tokens, finds a particular token, and returns the token as a 
55 String object The function assumes that a comma delimits the tokens and lets the user Indicate the posrtion of the token 
to retum. 

[0332] If the String to parse contains a null value or the specified token position is out of range, the function returns 
a null valua 
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String getTokenAt(Sti1ng,lnteger) 
[0333] 


Parameter Type 

Value 

(Stringjrtteger) 

String to parse, position of the token to find (starting with 0) 

Return Type 

Value 

String 

Indicated token, or a null value 


[0334] The following function parses a String object into token, finds a particular token, and returns the token as a 
15 String object. The functbn lets the user specify the character that delimits the tokens and lets the user indicate the posi- 
tion of the token to find. 

[0335] If the String to parse contains a null value or the specified token position is out of range, the function returns 
a null value. 

20 String g6tTokenAt(Str1ng,String,imeger) 
[0336] 


25 


Parameter Type 

Value 

(String.String. Integer) 

String to parse, delimiter, position of the token to f ind (starting with 0) 

Return Type 

Value 

String 

Indicated token, or a null value 


Examples: 
35 [0337] 

(1) A message item named Date is defined as a String object that contains a date in the format M/U/yy. For arxTther 
message, the user need the month from the value of Date in a String object The user wouU enter the function as 
follows: 

40 

getTokenAt (MsgDef.Date, T. 0) 

If Date contained '^13/00**, the function wouki retum a String object whose value is "2". 

(2) A message item named Date is defined as a String object that contains a date in the format MM.dd.yy. For 
45 another message, the user need the date from the value of Date in a String object The user would enter the func- 

tk>n as follows: 

getTokenAt (MsgDef.Date, T, 1 ) 

50 If Date contained "02.13.00", the function would return a String object whose value is '13". 

(3) A message item named Date is defined as a String object that contains a date in the format M/d/yyyy. For 
another message, the user need the year from the value of Date in a String object The user would enter the func- 
tbn as follows: 

55 getTokenAtMonth (MsgD^.Date. T , 2) 

If Date contained "2/13/2000". the functk>n would return a String object whose value Is "2000". 
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QeftYear 

[0338] This function fncte the year In a Calendar object and returns the year as an Integer object. 

Integer getYear(Calenctar) 

[0339] 


Paranrteter Type 

Value 

(Calendar) 

Calendar to read 

Return Type 

Value 

Integer 

Resulting Integer 


Example: 

[0340] A message item named DatePurchased is defined as a Calendar object For another message, the user 
need the year from the value of DatePurchased in an Integer otiject. The user would enter the function as follows: 

getYear (MsgDef. DatePurchased) 

If the value of DatePurchased were equivalent to February 13. 2000. the function would retum an Integer object wfrase 
value is 2000. 

integerToString 

[0341 ] There are two versions of this function. 

[0342] The following function converts an Integer object to a String object. 

String IntegerToStrfngPnteger) 

[0343] 


Parameter Type 

Value 

(Integer) 

Integer to convert 

Retum Type 

Value 

String 

Resulting String 


[0344] The following function converts an Integer object to a String ot>ject. using a format mask to format the String 
object 
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String integerToString(lnteger,String) 
[0345] 

5 


Parameler Type 

Value 

(Integer.String) 

Integer to convert, formal mask 

Return Type 

Value 

Sting 

Resulting String, tn the format specified by the mask 


Example: 

IS 

[0346] A message item named Quantity is defined as an Integer object. For another message, the user need the 
value of Quantity in a Sting object in the format #,###. The user would enter the function as follows: 

IntegerToString (MsgDef.Quantity. "#.###") 

20 

If the value of Quantity were 2540. the function would return a Sting object whose value is "2,540". 
isAlpha 

2S [0347] This function d^emvnes whether all characters in a Sting object are alphabetic and returns a Boolean 
object 

Boolean IsAlpha(String) 
30 [0348] 


Parameter Type 

Value 

(String) 

String to check 

Return Type 

Value 

When 

Boolean 

True 
F^lse 

All characters are alphabetic 
Not all character are alphat>etic 


isAlphaNumeric 

45 [0349] This furK:tion determines whether all characters in a String object are alphanumeric and returns a Boolean 
object 

50 
55 
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Boolean isAlphaNumertcCString) 
[0350] 


Parameter Type 

Value 

(String) 

String to check 

Return Type 

Value 

When 

Boolean 

True 
False 

AO characters are alphanumeric 
Not all character are alphanumeric 


IsNumeric 

[0351 1 This function determines whether all characters in a String object are numeric and returns a Boolean object. 

Boolean lsNumerlc(Strlng) 

[0352] 


Parameter Type 

Value 

(String) 

String to cheek 

Return Type 

Value 

When 

Boolean 

True 
False 

All characters are numeric 
Not all character are numeric 


justifyCenter 

[0353] Th^e are two versions of this furK^tion. 

[0354] The following function aeates a String object of the length indicated by an Integer object and centers a 
String object within it If the centered String shorter than the specified length, the function pads the String on each 
side with an equal number of spaces. 

[0355] If the centered String is longer tfian the specified length, the function returns a null value. 

String ]ustrfyCenter(String,lnteger) 

[0356] 


Parameter Type 

Value 

(Stringjnteger) 

String to center, length of the String to retum 

Return Type 

Value 

String 

Resulting String, or a null value 


[0357] The following function aeates a String object of the length indicated by an Integer object and centers a 
String object within it If the centered String )s shorter than the specified length, the function pads the String on each 
side wHh an equal number of characters specified in another String. 
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[0358] tf the centered String \s longer than the specified length, the function returns a null value. 
String justrfyC^er(String,lnteger,String) 
5 [0359] 


Parameter Type 

Value 

(String, 1 nteger.String) 

String to center, length of the String to return, and character to use to pad the String 

Return Type 

Value 

String 

Resulting String, or a mill value 


15 

Example: 

[0360] A message item named Name is defined as a String object. For another message, the user need the value 
of Name, centered in a String object of length 20. and padded if necessary with asterisks O. The user would enter the 
20 function as follms: 

JustifyCenter (MsgDef.Name, 20, 

If the value of Name were "Wolfgang A. MozarT. the function would retum a String object whose value is "^Wblfgang 
25 A. Mozart*". 

justifvLeft 

[0361 ] There are two versions of this function. 
30 [0362] The following function creates a String object of the length indicated by an integer object and left justifies a 
String object writhin it H the left-justified String is shorter than the specified length, the function pads the String with 
spaces on the right side. 

[0363] If the left-ji^ied String is longer than the specified length, the function returns a null valua 
35 String justifyLeft(String,lnteger) 
[0364] 


Parameter Type 

Value 

(String.lnteger) 

String to left justify, length of the String to retum 

Retum Ty(>e 

Value 

String 

Resulting String, or a null value 


[0365] The following function aeates a String object of the length indicated by an' Integer object and left justifies a 
String object within it If the left-justified String is shorter than the specified length, the function pads the String on the 
50 right side with characters specified in another String. 

[0366] tf the left-justified String is longer than the specified length, the function returns a null value. 


55 
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Parameter Type 

Vatue 

(String. Integer.String) 

String to left ju^. length of tfie String to return, and cfiaracter to use to pad the String 

Return Type 

N^lue 

String 

Resulting String, or a null value 


Example: 

IS 

[0368] A message item named Name is defined as a String object. For another message, the user need the value 
of Name, left justified in a String object of length 20, and padded if necessary with spaces. The user would enter the 
function as follcsws: 

20 JustifyLeft (MsgDef.Name, 20, 

If the value of Name were "Ranz Shubert", the function would retum a String object whose value Is "Franz Shuk>ert". 

justjfyRiqht 

25 

[0369] There are two versions of this function. 

[0370] The following function creates a String object of the length indicated by an Integer object and right justifies 
a String object within it. If the right-justified String is shorter than the specified length, the function pads the String with 
spaces on the left side. 

30 [0371 ] If the right-justified String is longer than the specified length, the function returns a null value. 
String ]ustlfyRight(Strlng,lnteger) 
[0372] 


Parameter Type 

Value 

(String,lnteger) 

String to right justify, length of the String to return 

Return Type 

Value 

String 

Resulting String, or a null value 


4S [0373] The follGwing function creates a String object of the length indicated by an Integer object and right justifies 
a String object within it. If the right-justified String is shorter than the specified length, the function pads the String on 
the left side with characters specified in another String. 

[0374] If the right-justified String is longer tfian the specified length, the function returns a null value. 
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String |ust}fyRight(Strlng,tnteger,Strfng) 
[0375] 


Parameter Type 

Value 

(String.lnteger.String) 

String to right justify, lengtti of the String to return, and character to to pad the String 

Return Type 

Value 

String 

Resulting String, or a null value 


Example: 

[0376] A message Item named Name Is defined as a String object. For arrather message, the user need the value 
of Name, right justified in a String object of length 20, arxi padded if rtecessary with asterisks (*), The i^er would enter 
the function as follcws: 


JustifyRight (MsgDef.Name. 20, 

If tfie value of Name were "Sergei Rachmaninoff, the function would retum a String object wfK>se value is ***Sergei 
Rachmaninoff". 

longToBiqPedmal 

[0377] This function converts a Long otsject to a BigDedmal object. 

BigDedmal longToBig[>ecinftal(Long) 

[0378] 


Parameter Type 

Value 

(Long) 

Long to convert 

Retum Type 

Value 

BigDedmal 

Resulting BigDedmal 


longToBoolean 

[0379] This function oonverls a Long object to a Boolean object. 
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Boolean longToBoolean(Long) 
[0380] 


Parameter Type 

Value 

(Long) 

Long to convert 

RetumType 

Value 

When 

Boolean 

True 
False 

Long is any value other than 0 
LongisO 


lonqToPoyt^ie 

[0381 ] This function converts a Long object to a Dout)le object. 
20 Double longToDouble(ljong) 
[03821 


Parameter Type 

Value 

(Long) 

Long to convert 

R^rn Type 

Value 

Double 

Resulting Double 


longToStrina 

35 [0383] There are two versions of this function. 

[0384] The following function converts a Long object to a String object 

String longToString(Long) 

40 [0385] 


Parameter Type 

Value 

(Long) 

Long to convert 

Return Type 

Value 

String 

Resulting String 


50 

[0386] The following function converts a Long object to a String object, using a format mask to format the String 
object 
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String longToString(Long,String) 
[0387] 

5 


Parameter Type 

Value 

(Long.Slring) 

Long to convert forniat mask 

Return Type 

Value 

String 

Resuftng String, in the format specified by the mask 


Example: 

15 

[0388] A message item named CustID Is defined as a Long object. For another mess^e, the user need the value 
of CustID in a String object, in the format ##,###. The user would enter the function as foRows: 

longToString (MsgDef.CustlD. "##.##r) 

20 

If the value of CustID were 10321. the function would return a String object whose value is "10.321". 
lookup 

25 [0389] There are two versions of this function. 

[0390] The following function looks up a String object in a kx>kup table specified in another String object and returns 
the corresponding value. If the function does not find a corresponcfing value in the lookup table, it returns a null value. 

String lookup(String^ng) 

30 

[0391] 


Parameter Type 

Value 

(String.String) 

String to look up, lookup table 

Return Type 

Value 

String 

Value found in the lookup table, or a null value 


[0392] The fbllcwing function looks up a String object in a kx>kup table specified in another String object and returns 
the conesponding value. If the function does not find a corresponding value in the lookup table, it returns a default value 
specified in a third String object. 

45 

String lookup(String3tring,String) 
[0393] 

50 


Parameter Type 

Value 

(String.String.String) 

String to look up lookup table, default value 

Return Type 

Value 

String 

Value found in the lookup table, or the default value 
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Example: 

[0394] A message item named Stale is defined as a String object State always contains a two-letter at)breviation 
for the name of one of three states in the United States. For another message, the user need the hA\ name of the state 
5 in a String object If no full name corresponds to the abbreviation, the user want the String object to contain "N/A". The 
user would enter the function as follows: 

lookup (MsgDef.Statep "MD=Maryland, PA=Pennsylvania, VA=Virginia". "hi/AT 

10 If the value of State were "VA". the function would retum a String object whose value Is 'Virginta". 

lowercase 

[0395] This function converts all characters In a String object to Icwercase. 

IS 

String lowercase(String) 
[0396] 


Parameter Type 

Value 

(String) 

String to convert 

Retum Type 

Value 

String 

Resulting String 


replaceStrinq 

30 

[0397] This function searches a String object for a particular String object replaces the found String object with a 

replacement String object and returns the String object with the replacement String in place. 

[0398] If the function cannot find the String to replace, it returns the String it searched without changing it. 

35^ String replaceString[String,String,String) 

[0399] 


Parameter Type 

Value 

(Slring.String.String) 

String to replace, replacement String. String to search 

Return Type 

Value 

String 

String with replacement String in place 


Example: 

50 [0400] A message item named Address is defined as a String object For addresses in the state of Virginia, the 
value in Address sometimes includes the two-letter abbreviation VA. For another message, the user need a String 
ot)ject that contains the value of Address, but with the full name of the state sut>stituted for the abbreviation. The user 
would enter the function as follows: 

55 replaceString fVA", "Virginia. MsgDef.Address) 

If the value of Address were "Reston. VA 201 sr. the function would return a String object whose value is 'Restoa Vir- 
ginia 20191". 
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replaceWord 

[0401 ] This function searches a String object for a particular word, replaces the found word with another word, and 
returns the String object with the replacement word In place. 
5 [0402] The function can only find the specified word wrtfiin the String object if the word is: (1 ) preceded and foUowed 
by white space: (2) left ji^ied within the String object and and follcwed by white space; and (3) right justified within the 
String object and preceded by white spaca If the function cannot find the word, it returr^ the String it searched without 
changing it. 

10 String replaceVVbnl(String,Strfng,String) 
[0403] 


Parameter Type 

Value 

(String.String. String) 

Word to replace, replacement word. String to search 

RetumType 

VSalue 

String 

String with replacement word in place 


Example: 

25 [0404] A message item named Address is defined as a String object For addresses in the state of Maryland, the 
value in Address sometimes includes the two-letter abbreviation MD. For another message, the user need a String 
object that contains the value of Address, but with the full name of the state sut>stituted for the abbreviation. The user 
would enter the function as follows: 

30 replaceWord CMD". "Maryland", MsgDef. Address) 

If the value of Address were "Bethesda. MD 20904". the function would return a String object whose value is "Bethesda, 
Maryland 20904". 

35 sizeOf 

[0405] There are two versions of this function. 

[0406] The following function det^mines the size of a String object and returns the size as a Long object. 
40 Long sizeOf(Sb1ng) 
[0407] 


45 


Parameter Type 

Value 

(String) 

String whose size to determine 

Retum Type 

Value 

Long 

Size of the String 


[0408] The following function determines the size of a ByteAn-ay object and returns the size as a Long object 

55 
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Parameter Type 

Value 

(ByteArray) 

ByteArray whose size to determine 

Return Type 

Value 

Long 

Size of the ByteArray 


stringToBigPecimal 

[041 0] This function converts a String object to a Big Decimal object. 

BIgDecinnal strlngToBigDeclmalStrlng) 

[0411] 


Parameter Type 

Value 

(String) 

String to convert 

Retum Type 

Value 

BigDecimal 

Resulting BigDecimal 


gtringTQBQQigan 

[041 2] This function converts a String object to a Boolean object 

Boolean strfngToBoolean(Strf ng) 

[0413] 


Parameter Type 

Value 

(String) 

String to convert 

Return Type 

Value 

Boolean 

Resulting Boolean 


strinqToCalendar 

[041 4] There are two versions of this function. 

[041 5] The following function converts a String object to a Calendar object 
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strfngToCalendar(Stitng) 
(0416] 


Parameter Type 

\^ue 

(String) 

String to convert 

Return Type 

Value 

Calendar 

Resulting Calendar 


[0417] The following function converts a String object to a Calendar object using a format mask to interpret the 
15 String object 

Calendar stringToCalendar(Str1ng,String) 

[0418] 


Parameter Type 

Value 

(String.String) 

String to convert, format mask 

Return Type 

Value 

Calendar 

Resulting Calendar 


30 Example: 

[0419] A message item named DatePurchased is d^ined as a String object ttiat contains a date in ttie format 
M/dJyy. For another message, the user need the Calendar equivalent off the value of DatePurchased in a Calendar 
object The user would enter the function as follows: 

35 

stringToCalendar (MsgDef.DatePurchased. "MAl/yy*^ 

If the value of DatePurchased were '*2/1 3A>0*. the furiction would retum a Calendar object wtiose value is the equivalent 
of February 13, 2000. 

40 

strlnqToDouble 

[0420] There are two versions of this function. 

[0421 ] The following function converts a String object to a Double object 

45 

Double strf ngToDouble(String) 
[0422] 


Parameter Type 

Value 

(String) 

String to convert 

Return Type 

Value 

Double 

Resulting Dout)le 
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[0423] The follGwing function converts a String object to a E>oi^e object using a format niask to interpret the String 
object 

Double stringToDouble(Strfng,Str1ng) 
[0424] 


Parameter Type 

Value 

(String.String) 

String to convert, format mask 

Return Type 

Value 

Double 

Resulting Double 


Example: 

[0425] A message item named TotalCost Is d^ined as a String object that contains a dollar amount in the format 
20 ##,###.##. For another message, the user need the value of TotalCost in a Double object. The user would enter the 
function as follows: 

stringToDouble (MsgDef.Totalcost, "##.###.#r) 

25 tf the value of TotalCost were "5,137.29", the function would return a Dout)le object whose value is 5137.29. 

stringTolnteqer 

[0426] There are two versions of this function. 
30 [0427] The following function converts a String object to an Integer object. 

Integer strtngTolnteger(Sti1ng) 

[0428] 


Parameter Type 

Value 

(String) 

String to convert 

RetumType 

Value 

Integer 

Resulting Integer 


45 [0429] The IbllGwing function converts a String object to an Integer ot>ject, using a format mask to interpret the 
String object 
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Integer stringTolnteger(String,Strlng) 
[0430] 

5 


Paranieter Typ>e 

Value 

(String.String) 

String to convert, format mask 

Return Type 

Value 

Integer 

Resulting Integer 


Example: 

IS 

[0431 ] A message Item named Quantity Is defined as a String object that contains an amount in the format #.###. 
For another message, the user need the value of Quantity in a String object The user would enter the function as fol- 
lows: 

20 stringTolnteger (MsgDef.Quantity, "#,##r) 

If the value of Quantity were "2.540". the function would return an Integer object whose value is 2540. 
strlngToLonq 

25 

[0432] There are two versions of ths function. 

[0433] The following function converts a String object to a Long object. 

Long str1ngToLong(Strlng) 

30 

[0434] 


Parameter. Type 

Value 

(String) 

String to convert 

Return Type 

Value 

Long 

Resulting Long 


[0435] The following function converts a String object to a Long object, using a format mask to interpret the String 
object 

45 Long stnngToLong(String^ng) 
[0436] 

50 


Parameter Type 

Value 

(String.String) 

String to convert, format mask 

Return Type 

Value 

Long 

Resulting Long 
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Example: 

[0437] A message item named CustID is defined as a String object that contains a number in the fonmat ##»###. 
For another message, the user need the value of CustID in a Long object The user would enter the function as follows: 

5 

stringToLong (MsgDef.CustID, "##,##r) 
If the value of CustID were **10.321 the function would return a Long object whose value is 10321 . 
10 subanay 

[0438] This function finds a ByteArray object within another ByteArray object and returns the found ByteAn^y 
object 

[0439] If the function cannot find the ByteAnay. it returns a null valua 

15 

ByteArray subarray(Long,Long,ByteArray) 
[0440] 


Parameter Type 

Value 

(Long.Long, ByteAnay) 

Position of the first byte of the ByteAnay to find, position of the last byte of the ByteAnay 
to find, ByteArray that contains the ByteArray to find; positions start with 0 

RetumType 

Value 

ByteAnay 

ByteArray that has been found 


30 [0441 ] Example A message item named Array is defined as a ByteArray object For another message, the user 
need the first eight t>ytes of Array in a ByteArray object The user would enter the functbn as follows: 

subArray (0. 7, MsgDef.Array) 

35 substring 

[0442] This function finds a String object within another Siring object arKi returns the found String object. 
[0443] If the function cannot find the String, it returns a null value. 

40 String substring(Long,Long,Strlng) 

[0444] 


Parameter Type 

Value 

(|jong,Long,String) 

Position of the first character of the String to find, position of the last character of the String to 
find. String that contains the String to find 

Retiffn Type 

Value 

String 

String that has been found 


trim 

55 

[0445] This function removes white space before and after a String object 


54 


string trim(String) 
[0446] 


EP1016989A2 


Parameter Type 

Value 

(String) 

String object from which to remove white space 

Return Type 

Value 

String 

Resulting String 


u ppercase 

[0447] This function converts all characters in a String object to ippercasa 

String uppercase(String) 

[0448] 


Parameter Type 

Value 

(String) 

String to convert 

Return Type 

Value 

String 

Resulting String 


[0449] The examples shown and desaibed herein above are not meant to limit the scope of the invention. Accord- 
ingly, modifications and variations according to the present invention will become apparent to those of ordinary skill In 
the art witfraut departing from the spirit and scope of the appended daims. 

Clain^ 

1 . A system for integrating a plurality of computer applications, comprising: 

an enterprise messaging system, said enterprise messaging system passing messages between said compu- 
ter applications; 

a database storage system coupled to said enterprise messaging system, said datat^se storage system stor- 
ing a plurality of data transformation configurations and a plurality of rules; 

an integration service coupled to said enterpr^ messaging system, said integration server comprising a data 
transformation engine using the data trar^formation configurations stored in said database storage system 
and a rules evaluation engine using the rules stored in said datak>ase storage system; 
a plurality of agent-adapters coupled to said enterprise messaging system, each agent-adapter cotpled to a 
respective one of said computer applications, each agent-adapter passing messages between said enterprise 
mess^ing system and said respective computer application; and 

a message schema operating in conjunction with said agent-adapters to parse individual message elements 
from the conrputer applications^ 

2. The system according to daim 1 , wherein said Integ'ation service system splits and combines messages received 
from said enterprise messaging system and performs content-based routing of messages to said computer appli- 
cations. 

3. The system according to daim 1 , wherein each said agentnadapter translates messages being passed from said 
enterprise messaging system to said respective computer application from a system format to a respective compu- 
ter application format, and translates messages being passed from said respective computer application to said 
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enterpr^ messaging system from the respective corrputer application fomiat to the system fonmt. 

4. The system according to claim 1 , wherein each said agent-adapter further passes messages t>etween other said 
agent-adapters and said respective computer application. 

5. The system according to daim 1 . wherein each said agent-adapter comprises an adapter portion and an agent por- 
tion encapsulating said adapter portion. 

6. The system according to daim 1 . wherein each said agent-adapter conrprises om or more adapter portions and 
an agent portion erK^apsulating all of said one or mae adapter portions. 

7. An improved enterprise application integration system including an agent-adapter for use therein, the improvement 
comprising: 

an adapter configured for a selected one of the enterprise applications; 
an agent service hosting said adapter; 

a message definition for each of a plurality of messages said adapter will produce, receive, or reply to; 
means for connecting said adapter to said selected enterprise application; and 
means for implementing said adapter through said connecting m^ns. 

8. The improvement accorcGng to daim 7. wherein said adapter is selected from the group consisting of a source 
adapter, a target adapter, a reply adapter, and a request adapter. 

9. A method for passing messages between a first corrputer application aixi a second computer application, corrpris- 
ing the steps of: 

providing a first message having a first data from said first computer application; 
publ^ing said first message to obtain a first published message; 

converting said first data of said first published message to a second data to obtain a second message; 
publ^ing said second message to obtain a second published message; and 
providing said secorxJ published nrtessage to said second corrputer application. 

10. The method according to daim 9, further corrprising the steps of: 

translating said first message from a first corrputer application format to a system format prior to publishing 
said first message; artd 

translating said second put)lished rrressage from said system format to a second conputer application format 
prior to providing said second putriished message to said second computer application. 

11 . The method according to 9, wherein said step of converting said first data oonprises: 

requesting said second data from a datat)ase; and 
receiving said second data from said database. 

12. An agent-adapter for use in an enterprise application integration system, which integrates a plurality of errterpr^ 
applications, corrprising: 

an adapter configured for a selected one of the enterprise applications; 
an agent service hosting said adapter; 

a message definition for each of a plurality of messages said adapter will produce, receive, or reply to; 
means for connecting said adapter to said selected enterprise application; and 
means for implementing said adapter through said connecting means. 

13. The agent-adapter according to daim 12, wherein said adapter is selected from the group consisting of a source 
adapter, a target adapter, a reply adapter, and a request adapter. 

14. The agent-adapter according to daim 1 3. wherein said adapter corrprises a source adapter and further comprising 
means for designating selected ones of a plurality of targets said source adapter is adapted to serxi one or more 
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messages. 

1 5. The agent-adapter according to daim 1 3, wherein said adapter comprises a target adapter and further comprising 
means for designating selected ones of a plurality of sources from which said target adapter is adapted to receive 

5 one or more messages. 

16. The agent-adapter according to daim 13. wfierein said adapter comprises a reply adapter arxi further conrprising 
means for designating selected ones of a plurality of requesters to which said reply adapter is adapted to send one 
or more reply messages. 

10 

1 7. A method for passing messages between a first computer application and a second conputer application, conrpris- 
ing the steps of: 

providing a first message having a first data from said first computer application; 
15 publishing said first message to obtain a first published message; 

converting said f ir^ data of said first put)lished message to a second data to obtain a second message; 
publishing said second message to obtain a second published message; and 
providing said second published message to said second corrputer application. 

20 18. The method according to daim 17. further compr^ng the steps of: 

translating said first message from a first corrputer application format to a system format prior to put)lishing 
said first message; and 

translating said second published message from said system format to a second computer application format 
25 prior to providing said second put)lished message to said second corrputer application. 

1 9. The method according to 1 8, wherein said step of converting said first data corrprises: 

requesting said second data from a database; and 
30 receiving said secorxl data from said database. 

20. The metfuxJ according to daim 1 9. further corrprising the steps of: 

providing an adapter configured for a selected one of said corrputer applications; 
35 providing an agent service to host said adapter; .^^ 

defining a message definition for each of a plurality of messages said adapter will produce, receive, or reply to; 
and 

connecting said adapter to selected corrputer application. 

40 21 . In an enterprise application integration system that integrates a plurality of enterprise applications, each of which 
have a respective native format fa aeating. sending, receiving, storing, and processing a plurality of messages, 
the irrprcvemerrt corrprising: 

an agent-adapter including a plurality of adapters encapsulated by an agent; 
45 wherein each of said plurality of adapters errcapsulated by said agent indudes means for performing a disaete 

function while encapsulated fc>y said agent 

22. The irrprovement according to daim 21 . wfierein said agerrt further corrprtees a plurality of objects erTt>edded 
therein, each of said plurality of objects adapted to perform a discrete function. 

50 

23. The improvement according to daim 22. wherein a first of said plurality of objects errtjedded in said agerrt further 
corrprises means for managing connections of said agent-adapter t>etween seleded ones of the plurality of enter- 
prise applications and the system. 

55 24. The improvement according to daim 23. wherein a second of said plurality of objects errt>edded in said agent fur- 
ther corrprtees means for managing errors detected in said agent-adapter between selected ones of the plurality 
of enterprise applications and the system 
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25. The mprovement according to daim 23, wherein a third of said plurality of objects embedded in said agent further 
comprises means for managing a transformation of the plurality of messages within said agent-adapter between 
selected ones of the plurality of enterprise applications and the system. 

26. The improvement according to daim 22, further comprising a plurality of nodes and a plurality of system services 
resident on said nodes. 

27. The inprcvment according to daim 26. wherein said agent further comprises a plurality of objects embedded 
therein, each of said plurality of objects adapted to perform a disaete function. 

28. TTie imprcvement according to daim 27, wherein each of said plurality of objects embedded in said agent 't& 
adapted to perform its respective function at any one of said pluraTity of nodes. 

29. The improvement according to daim 27, wherein each of said plurality of objects ennbedded in said agent is 
adapted to perform its respective function in conjunction with respective ones of said otsjects embedded in another 
agent in the system. 

30. A system for integrating a plurality of computer applications, comprising: 

an enterprise messaging system, said enterprise messaging system passir^ messages between said compu- 
ter applications; 

a datat)ase storage system coupled to said enterprise messaging system, said database storage system stor- 
ing a plurality of data transformation configurations and a plurality of rules; 

an integration service coupled to said errterpr^ messaging system, said integration server comprising a data 
transformation engine using the data transformation configurations stored in said database storage system 
and a rules es^uation engine using the rules stored in said database storage system; and 
a plurality of agent-adapters coupled to said enterprise messaging system, each agent-adapter coupled to a 
respective one of said computer applications, each agent-adapter passing messages k>etween said enterprise 
nrtessaging system and said respective computer applicatioa 

31 . The system according to daim 30, further corrprtsing: 

a message schema, induding a plurality of message elements; 

a plurality of accessors, each of which is adapted for a selected one of said computer applications; and 

a plurality of converters, each of which is adapted for a selected one of said conputer applications and adapted 

to be coupled to selected ones of said plurality of accessors; 

wherein selected ones of said plurality of message elements corresponding to one of said computer applica- 
tions are adapted to be accessed and converted for conrununication with another of said conrputer applications. 

32. The system according to daim 31 . wherein said plurality of accessors and said plurality of converters are distrib- 
uted throughout the system. 
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